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SMS GRATIS 

DAL TUO CELLULARE 

Costruiamo un'applicazione J2ME 
che consente di inviare SMS via GPRS 



0Come realizzare 
l'applicazione client 
e il componente server 

Tutto il codice 
commentato 
riga per riga 

0Nel CD l'eseguibile 
Java da installare 
subito sul telefonino 
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Penetrare nei PC 

1 con una JPEG inviata da remoto! 

Esclusivo: l'autore dell'exploit dell'anno ci svela 
segreti per sfruttare la clamorosa falla di Windows 



SOFTWARE 
ESTENSIBILE 

Sviluppare applicazioni 
pronte per i plug-in 



JAVA DISEGNA 
LE INTERFACCE 

Trasformare in codice Java 
le form di Visual Basic 
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VB .NET 



IN ESCLUSIVA 



DA NON PERDERE 



Visual Basic Power Pack 

Sette nuovi controlli 
completamente gratuiti 



SISTEMA 



XAML: ora le interfacce 
le disegno in Photoshop! 
Interpretare WordML 
e pubblicare via RSS 
Java Swing in pratica 



ELETTRONICA 



Collega un radiocomando 
al computer 



INTERNET 



Web Services in Java: 
un esempio completo 
WSE 2.0: il futuro 
dei servizi Web in .NET 

Pubblicare pagine 
per i-mode 



CORSI 



ECLIPSE: le interfacce 
grafiche con SWT 

JAVA: software più 
robusto con le eccezioni 

C#: attributi e puntatori 
VISUAL BASIC: le nostre 
interfacce 
in stile XP 
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iPOD: UN'APPLICAZIONE CHE 
RECUPERA I DATI DAL PLAYE 



CONTENTS T H Questo mese su ioProgrammo 
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V Rovescio d'autore 

È dell'ultima ora la notizia che Kodak ha chiesto un risarcimento 
di 1000 milioni di dollari (!) a Sun per la violazione di alcuni suoi 
brevetti nel codice di Java. Mi chiedo: quanto dovrà andare 
avanti questa guerra alla ricerca del codicillo? Siamo davvero 
sicuri che leggi restrittive sul diritto d'autore siano la migliore 
garanzia per un effettivo progresso tecnologico ed economico? 
Non dimentichiamo che è questo il fine ultimo della tutela del 
diritto d'autore: favorire la ricerca e lo sviluppo. Una tutela 
eccessiva comincia invece a diventare un freno. 
ioProgrammo non ha mai fatto guerre di religione, a favore o 
contro l'Open Source, eppure il moltiplicarsi di azioni legali e di 
processi invita ad una riflessione più profonda. Il caso di Sun, 
che passa da carnefice (vedi il caso Microsoft) a vittima di questo 
sistema, è emblematico della oggettiva difficoltà cui si va incon- 
tro nell'operare nella programmazione senza incorrere in qual- 
che infrazione legale. 

Restando in Italia, le leggi sul diritto d'autore sono solo una pic- 
cola parte rispetto a quelle cui deve prestare attenzione uno svi- 
luppatore che lavora in proprio o un'azienda informatica: i dubbi 
su cosa sia possibile distribuire e attraverso quale licenza sono 
moltissimi e sono in molti a chiedere un aiuto. ioProgrammo 
non può cambiare le leggi. Proveremo a spiegarle: non mancate 
i prossimi appuntamenti. 

Raffaele del Monaco 
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► Demoscene 

Teoria & Tecnica 
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SMS gratis 

Un'applicazione aperta ai plug-in 

Interfaccie grafiche da VE a Java 

La pubblicazione di articoli con RSS (2 a parte) 

Le novità di Java 1.5 (2 a parte) 

Stock Spy 

Web Service e Fantacalcio (3 a parte) 

Tips&Tricks 



VE Power Pack 

Instant Messenger con WSE 2 

I corsi di ioProgrammo 
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Interfacce vettoriali in XAML 
iPod: estrazione dei brani con C# 

Soluzioni 



All'inizio di ogni articolo, troverete un nuovo simbolo che indicherà la 
presenza di codice e/o software allegato, che saranno presenti sia sul CD 
(nella posizione di sempre \soft\codice\ e \soft\tools\) sia sul Web, all'indirizzo 
http: / / cdrom.ioprogrammo.it. 

Per scaricare software e codice da Internet, ogni mese indicheremo una 
password differente. Per il numero che avete fra le mani la combinazione è: 



Username: giancarlo Password: cromalin 



InBox 



wB> 



21 
27 
34 
39 
47 
b2 
55 

60 



Exploit 


65 


► Metti il virus nella JPG 
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► Radiocomando per PC 
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► Creare siti per i-mode (2 a parte) 
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Eclipse • Sviluppare in Java con Eclipse 3 (2 a parte) 

VB .NET • Leggere e scrivere nei file 92 
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► Costruzioni geometriche iterative 
L'enigma di ioProgrammo 
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JPEG: UNA 
BRUTTA 
FIGURA PER 
MICROSOFT 

L! ultimo ciclone che ha 
colpito Microsoft ri- 
guarda le immagini JPEG e 
ha creato un vastissimo al- 
larme in tutto il mondo. 
Un exploit che sfrutta una 
falla di GDI+ e che ha tra- 
sformato in realtà l'incubo 
degli utenti Windows: la 
possibilità che anche le im- 
magini si trasformino in vet- 
tori di virus. 

Protagonista dell'exploit è 
stato uno dei migliori colla- 
boratori di ioProgrammo, 
Elia Florio, intervistato per 
l'occasione da numerosi 
magazine americani. Tutti i 
dettagli a pagina 64! 

DVD DA 1 
TERABYTE 

Questa è la promessa di 
un gruppo di ricerca- 
tori dell'Imperiai College 
di Londra: stanno metten- 
do a punto una tecnologia 
che entro dieci anni por- 
terà al grande pubblico 
supporti da 1000 Gigabyte. 
Con una capacità equiva- 
lente a 100 degli attuali 
DVD, i nuovi supporti 
avrebbero la stessa dimen- 
sione e sarebbero compa- 
tibili con gli attuali lettori. 
Il nuovo medium si chia- 
merà MODS (Multiplexed 
Optical Data Storag) e 
trarrà la sua forza dalla ca- 
pacità di riconoscere 300 
variazioni per pit (l'unità 
di scrittura del DVD) a 
fronte dell'attuale capacità 
di distinguere fra due soli 
stati (0 e 1). Già questa sin- 
gola modifica, compren- 
dendo la correzione di er- 
rore, porterà da sola un 
fattore di 10 nella capacità 
di immagazzinamento del- 
le informazioni. 
www.ic.ac.uk 
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OQO: IL PC 
ll\l PALMO 
DI MANO 

La compagnia americana 
OQO, con quasi due anni 
di ritardo, ha annunciato di 
essere pronta a lanciare sul 
mercato un PC "full-optio- 
nal" delle dimensioni di un 
Pocket PC: OQO model 01. 



NUOVO RECORD 
MADE IN USA 




Queste le caratteristiche sa- 
lienti: processore Transmeta 
da 1GHz, Hard Disk da 
20GB, 256MB di RAM, scher- 
mo retroilluminato 800x480, 
pieno supporto per la con- 
nettività wireless (Wi-Fi, 
Bluetooth), porta USB e Fi- 
reWire, microfono integra- 
to. L'interattività è garantita 
dal comodo touchscreen. Il 
peso si aggirerà sui 400 
grammi. Non c'è che dire: 
un bel gioiellino. Il prezzo 
dovrebbe essere compreso 
fra i 1500$ e i 2000$. 

www.oqo.com 



Erano ormai due anni 
che l'America provava 
a riappropriarsi della pal- 
ma di computer più veloce 
del mondo. Nel 2002 la 
giapponese NEC aveva in- 
fatti strappato il primato 
con un cervellone capace 
di 36,01 tera- 
flop, il celebre 
Earth Simula- 
tor. È IBM a 
riuscire nel- 
l'impresa con 
un nuovo su- 
percomputer 
che, sebbene 
ancora in ver- 



sione beta, ha già raggiun- 
to i 35,86 teraflop. Blue Ge- 
ne, questo il nome del 
nuovo supercomputer, si 
avvale di un'architettura 
rivoluzionaria rispetto ai 
suoi predecessori: una ti- 
pologia che IBM definisce 



r Nodi 


65,536 


CPU per nodo 


2 


CPU totali 


131,072 


Velocità delle CPU 


667 MHz 


Prestazioni teoriche 


360,000 GFlop/s 


Memoria per nodo 


512 Mega Byte 


Memoria totale 


32 Tera Byte 


Tipo di memoria 


DDR DRAM 


Memoria su disco 


800 Tera iBytea 


. SmsSencler.ziii 




DA MICROSOFT UN LINGUAGGIO 
DI PROGRAMMAZIONE VISUALE 
DEDICATO Al ROBOT 



Microsoft, in occasione di un even- 
to svoltosi in Belgio, ha presenta- 
to il nuovo framework chiamato Visual 
Robot Development Kit (VRDK) . 
Il VRDK contribuirà a ispirare i futuri 
ingegneri consentendo loro di pro- 
grammare con facilità dei robot "gio- 
cattolo" che siano capaci di compiere 
semplici compiti e che possano essere 
controllati attraverso uno smartphone 
basato sul sistema operativo Windows 
Mobile", ha dichiarato Microsoft in un 
comunicato. 

www.research. microsoft, com 
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"a celle", e che 
consente un ri- 
sparmio di energia 
e di spazio di circa 
due ordini di gran- 
dezza. Basato su 
Linux, il progetto è 
nelle sue prime fa 




di sviluppo e fa 
attualmente affida- 
mento su 16.000 
processori, men- 
tre, nella fase fina- 
le, potrà contare su 
131.000 con l'o- 
biettivo di supera- 
re i 360 teraflop. 
www.research.ibm.com/bluegene 
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UN NEGATIVO PER LE 
FOTOCAMERE DIGITALI 

A dobe sta spingendo perché le case produttrici di 
>grafiche digitali adottino un forma- 
to unificato, al posto degli attuali RAW. DNG, Digital 
NeGative, è stato progetttato sulla base di TIFF EP, il 
medesimo che si trova alla base dei RAW attualmente 
utilizzati e che tanti problemi di incompatibilità porta- 
no. Il formato RAW è infatti direttamente legato al 
sensore utilizzato dalla macchina fotografica dunque: 
tutte le informazioni raccolte dal sensore si ritrovano 
dunque nel RAW, preservata da qualsiasi manipolazio- 
ne. Questa caratteristica ha fatto del RAW il miglior 
formato per macchine di fascia alta e professionali, a 
scapito però della compatibilità. DNG si propone di es- 
sere l'uovo di colombo: massima qualità all'interno di 
un formato standard. 

www.adobe.com/dng 




URI SUPERCOMPUTER 
PER SURI . ,. 



un Microsystem e l'Università del Texas hanno rive- 
lato di essere pronti ad avviare un supercomputer 
per l'analisi di grosse masse di dati. Maverick è il no- 
me del nuovo cervellone che, basato su server Sun Fire 
E25K, sarà utilizzato nel centro di ricerche UT Austin's 
Texas Advanced Computing Center. I dettagli finanzia- 
ri del progetto non sono stati svelati anche se l'ordine 
di grandezza si può supporre di qualche milione di 
dollari. Maverick riunisce il meglio della tecnolr- 
sia nella visualizzazione dei risultati che nello se 
bio di dati via rete, indispensabile per poter accedere 
all'enorme quantità di dati da elaborare, ad esempio 
in campo meteorologico. Il sistema utilizza 64 pro- 
cessori UltraSparc 4 ed ha a disposizione 512 gigaby- 
te di memoria condivisa. Ovviamente, il sistema o 
rativo scelto è Solaris. 




ivivw.sun.com 



FLEXWIKI: ANCORA OPEN 
SOURCE PER MICROSOFT 



La tentazione verso il software Open 
Source è sempre più forte per Microsoft: 
questa volta tocca a FlexWiki, un sistema di 
collaborazione per la creazione di siti "coo- 
perativi". Il modello è quello di WikiPedia, 
per intenderci, dove chiunque può pubbli- 
care e modificare quanto pubblicato da al- 
tri. FlexWiki è scritto in C# e segue a breve 



distanza altri due progetti rilasciati da 
Microsoft come Open Source: Windows 
Installer XML e Windows Templater Library. 
Che sia un modo per capire le dinamiche 
dello sviluppo Open Source? Quel che è cer- 
to è che la comunità Open Source si arric- 
chisce di un altro "pezzo pregiato". 

http://sourceforge.net/projects/flexwiki 



PALM OS 

A CACCIA DI 

SMARTPHONE 

PalmSource, produttore di 
Palm OS, ha annunciato 
la disponibilità di un nuovo 
sistema operativo progettato 
specificamente per smart- 
phone: Palm OS Cobalt 6.1 
Le incerte prospettive di 
mercato dei PDA hanno 
spinto PalmSource verso 
quello che promette di esse- 
re l'eldorado dei prossimi 5- 
10 anni: i telefonini di fascia 
alta. Il nuovo sistema opera- 
tivo supporta nativamente 
Wi-Fi e Bluetooth e, offre la 
più vasta scelta per la gestio- 
ne della connettività: Blue- 
t o o t h , 
memory 
card SD, 
USB. 

Sono attesi 
per la fine 
dell'anno i 
primi di- 
spositivi 
con instal- 
lato il nuo- 
vo sistema 
operativo. 
www.palmsource. com 
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IL muovo 3D 

DI MICROSOFT 

"GF 1.0 prenderà il po- 
sto delle Direct3D 10. 
Nella prossima release delle 
DirectX scomparirà la tec- 
nologia Direct3D a favore 
delle nuove API Windows 
Graphics Fondation 
Le Windows Graphics Fon- 
dation si integreranno ap- 
pieno nella nuova tecnolo- 
gia Avalon, parte del prossi 
mo sistema operativo Mi- 
crosoft: Longhorn. 

I PORTATILI 



I DESKTOP 

ntel annuncia la 
disponibilità di 
un processore per 
" notebook di fa- 
scia desktop-replacement 
con una frequenza di 3,3 
GHz, molto vicina ai più ve- 
loci modelli Pentium 4. 

II nome del nuovo proces- 
sore è Mobile P4 548 ed è 
caratterizzato da un consu- 
mo massimo di 88 watt, ad 
una tensione compresa fra 
1,25 e 1,4 volt. 



Il prezzo, per mille unità, è 
di circa 260 dollari. Il P4 548 
supporta la tecnologia Hy- 
per-Threading ed è costrui- 
ta attraverso un processo a 
90nm. 

Offre 1MB di memoria per 
la cache di secondo livello 
ed è compatibile con i chip- 
set Intel 852 GME e 852PM. 
www.intel.it 



FIREFOX I.O PREVIEW: 
PARTENZA A RAZZO! 



mj09^k O uperando le aspettative 
J| fe'j O della Mozilla Founda- 
u tion che prevedeva di supe- 
/ rare il milione di copie sca- 
ricate in dieci giorni, la ver- 
sione preview di Firefox 1.0 è stata scarica- 
ta in cinque giorni da 1,3 milioni di perso- 
ne. Dopo che Microsoft ha in pratica ab- 
bandonato lo sviluppo di Internet Explorer 
come prodotto stand-alone, Firefox si tro- 
va a "fronteggiare" l'entusiasmo di milioni 
di utenti che sembrano aver finalmente 
trovato un'alternativa valida al browser di 
casa Microsoft. IE, anche a causa della sua 
estrema diffusione, ha offerto il fianco a 



numerose critiche riguardo alla sicurezza, 
critiche che cominciano a toccare anche 
Firefox. "Da grandi poteri derivano grandi 
responsabilità": ora Firefox dovrà dimo- 
strare di valere la posizione di sfidante uffi- 
ciale di IE. L'apprezzamento di cui gode Fi- 
refox poggia essenzialmente su quattro pi- 
lastri: stabilità, velocità, ricchezza di plug- 
in e "immunità" a virus e Spyware che han- 
no afflitto negli ultimi anni IE. Proprio 
questo fronte dovrà essere curato maggior- 
mente: pare infatti che cominciano a dif- 
fondersi i primi co dici malevoli contro 
Firefox. Si riaccende la guerra dei browser? 
www. mozilla. org 



Z mozilla 




Firefox 

rediscover the web 
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Firefox Preview Release is the award winnir 
of Mozilla's next generation tarawser. FirefoK 
empowers you te browse fester, more safely 
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Support Stare Developei s About 






Download Now! 

for Windows, English (4,5MB) 


<> 




Or. qet the Firefox CD & 

Guidebonk from the Mozilla Store. ■2P 



more effìciently than with any other browser. Make 
the switch today --FirefoM irnports your FavariteSj 
settings and other informa tionj so you nave nothing 
to Idsb, 
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UN'ALLEANZA 

PER GLI SMARTPHONE 



Tre giganti del calibro di Nokia, Intel e 
Symbian hanno siglato un accordo di 
cooperazione per lo sviluppo di dispositivi su 
piattaforma 3G. Lo scopo è quello di creare 
una piattaforma di riferimento che unisca: i 
chip CScale di Intel, il sistema operativo di 
Symbian e l'interfaccia Series 60 di Nokia. 
Dato il peso dei tre, l'accordo potrebbe fare 
da polo gravitazionale per tutti gli altri co- 
struttori di telefonini, raggiungendo uno 
standard de facto che, oltre a semplificare la 
vita agli utenti, solleverebbe molti produttori 
dagli oneri della ricerca. 
È chiaro che Intel vorrebbe ripetere lo stesso 
modello di Business che l'ha vista trionfare 
nel mercato dei PC grazie alla partnership 
con Microsoft: l'obiettivo sembra essere tra- 
slare modello Wintel nel mercato mobile. 
Dopo aver già raggiunto lo status di prima 
scelta sia per gli smartphone basati su Win- 




dows Mobile, sia per quelli che montano 
Palm OS, Intel si conferma dunque riferi- 
mento per il mobile. 
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Borland Together Designer CE 

La modellazione professionale per tutti gli sviluppatori 



Un ambiente di modellazione gratuito 
di livello professionale per la creazio- 
ne di diagrammi UML (Unified Modeling 
Languagé) standard. Questa release offre 
ad architetti, analisti aziendali e sviluppa- 
tori l'opportunità di godere dei vantaggi le- 
gati alla modellazione a costo zero. Tra le 
principali caratteristiche di Together Desi- 
gner Community Editing segnaliamo: 

• Creazione di diagrammi UML 2.0 e 
UML 1.4. 

• Creazione di diagrammi in formato 
immagine (*svg, *bmp e *gif). 

• XMI per l'importazione UML. 

• Importazione di modelli *.mdl di 
Rational Rose. 

• Creazione di diagrammi ER logici. 

L'INTERFACCIA 

L'esperenzia di Borland la si trova riversata 
subito nel look&feel dell'applicazione che, 
attraverso un sapiente uso del colore e de- 
lle icone, riesce comunicare all'utente una 











- 


Pr operi le s 




















Filin 




quali lied narne 






effect 






visibility 


□ 




must isolale 


□ 










+■ Hyperlink 


- 


View 










background Golor 


<de1 aulti 


U 


1 ciré-ground color 


font ternily 


tori) size 


^default? 


□ 




3D look 


defsult 


m 










ii 


Descript io n 






m 


Sequirements 






■in 


C Listoni 















Fig. 2: Con l'Inspector 
possiamo modificare 
qualsiasi elemento 

zionate e modificate 
nello Inspector. 



grande immedia- 
tezza, anche a di- 
spetto della inevi- 
tabile complessi- 
tà dell'ambiente. 
Tutti i compo- 
nenti del progetto 
si posizionano 
con un semplice 
drag&drop, men- 
tre le proprietà di 
ogni oggetto pos- 
sono essere ispe- 
con l'apposito pan- 



- - a •* 
; » 
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Fig. 1: Gli Activity Diagram sono fra le novità di UML 2.0 



UML 2.0 

Together consente di lavorare sia secon- 
do lo standard UML 1.4 sia con il 2.0, 
inoltre risulta molto interessante la pos- 
sibilità di convertire diagrammi UML 
1.4 nella versione 2.0 attraverso un 
apposito wizard. La nuova versione di 
UML si arricchisce di nuovi diagrammi 
dedicati alla model- 
lazione architettura- 
le, aggiungendo an- 
che alcune migliorie 
nei diagrammi già 
esistenti. Mentre gli 
Use Case Diagrammi 
restano pressoché 
identici, gli Activity 
Diagram sono stati 
profondamente rivi- 
sti: non più specializ- 
zati in una rappre- 
sentazione di automi 
a stati finiti, gli Atti- 
viti Diagram si pon- 



H 1 ÌB tf Si UML-2.0.tp>: 



gono ora a metà strada fra i tradizionali 
Data Flavo Diagram (DTD) ed i flow 
chart. A voi scoprire le altre novità di 
UML 2 con Togheter! Oltre ai diagrammi 
UML nelle due versione, Togehter offre 
anche la possibilità di definire diagram- 
mi Entità-Rela- 
zione in modo 
del tutto coeren- 
te con i progetti 
UML che svilup- 
piamo: ottima 
idea, conside- 
rando che è or- 
mai difficile im- 
maginare un 
progetto softwa- 
re che non inclu- 
da un database. 



] UML-2.0.tpx 
I & <detauf> 

^ =defaoft* 
J3 Application Server 
Submachine Sigle 
^ Process Order 
Coorse Attempt 
^ Final Notìes 
aà^ Ctasses and Festures 

:/:.>• • e-: : >.. ■• ■ 
]'3 Composte Strutture 
B^ 1 Store Componenti 
| I Data Activfty 
ffi ^ teatures 
Ei Gfc associatlons 
* curnpostestruciijres 

29 New In UML 2.0.ntml 



Fig. 3: Dal pannello 
Project si controlla 
l'intero progetto 



INSTALLAZIONE 

L'installazione del software è semplicissi- 
ma, in pratica basta un doppio clic sul file 
di setup. Il prodotto è gratuito e, al primo 
avvio, è richiesta una chiave di attivazione 
per ottenere la quale è necessario collegar- 
si al link www.borland.com/products Idow- 
nloadsldownload_together.html, registran- 
dosi al sito della Borland se non si è già 
iscritti. Ovviamente non è necessario sca- 
ricare il file di installazione dal sito, essen- 
do già presente nel CD allegato alla rivista. 



I 



Together Designer 
Community Edition 

Produttore: Borland 
Sul web: www.borland.it 
Prezzo: Gratuito 
Nel CD: WogetherCE 
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Java 2 SE SDK 5.0 

Alla scoperta delle novità di Tiger 



Dopo anni di spasmodica attesa, final- 
mente possiamo mettere le mani 
sulla nuova versione del linguaggio più 
amato dai programmatori: nome in codice 
Tiger. Le nuove caratteristiche del linguag- 
gio hanno una cosa in comune: prendono 
alcuni costrutti idiomatici usati general- 
mente dai programmatori e ne forniscono 
un supporto linguistico. In altre parole, è 
stata spostata dal programmatore al com- 
pilatore il compito dello scrivere il cosid- 
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Fig. 1: La struttura della nuova piattaforma 



detto "boilerplate code", quelle porzioni di 
codice che si ripetono sempre immutate 
da un programma all'altro e che hanno 
l'unico scopo di introdurre errori. . . Grazie 
al fatto che il compilatore, a differenza del 
programmatore, non commette errori, il 
codice prodotto risulta essere meno sog- 
getto a bug. 
I principali miglioramenti: 

• Generics: fornisce dei meccanismi di 
controllo a tempo di compilazione per le 
collection ed elimina la noia di effettuare il 
casting 

• Miglioramenti nei cicli: avremo degli 
iteratori più semplici e più immuni da 
errori 

• Autoboxing/unboxing: elimina la 
necessità della conversione manuale tra 
tipi primitivi (ad esempio int) e wrapped 
(Integer) 

• Typesafe enums: tutti i noti benefici 
della struttura Typesafe Enum, senza la 



passata prolissità e la conseguente ten- 
denza a causare errori 

• Import statico: non sarà più necessa- 
rio qualificare i membri statici con il nome 
della classe cui appartengono 

• Metadata: supporto per i metadati 
consentirà ai vari tool disponibili di gene- 
rare codice automaticamente, a partire 
dalle annotazioni indicate nel codice. 

L'innovazione risulta particolarmente 
interessante, perché porta ad uno stile di 
programmazione "dichiarativo", in cui il 
programmatore "dice" cosa deve essere 
fatto ed i tool di turno generano il codice 
che soddisfa la richiesta. 



Java 2 SE SDK 5.0 

Produttore: Sun Microsysems 
Sul web: www.sun.com 
Prezzo: Gratuito 
Nel CD: java 5 sdk 



Macromedia Contributo 3 

L'aggiornamento dei siti "for dummies"! 



Con questa nuova versione, il software 
di Macromedia permette anche agli 
utenti meno esperti di aggiornare le pagi- 
ne di siti web o quelle della Intranet con la 
stessa semplicità con cui potrebbero ge- 
nerare un qualsiasi documento Word. Ma- 
cromedia Contribute 3 dispone ora di un 
miglior sistema di controllo dell'ammini- 
strazione, di una serie di miglioramenti 




Fig. 1: L'interfaccia di Contribute si 
presenta poco più complessa di un browser 



nell'editing e dell'integrazione con il siste- 
ma publishing di Dreamweaver MX 2004. 
Gli amministratori non devono fare altro 
che stabilire chi ha i permessi di pubblica- 
zione e chi può effettuare solo editing. In 
questo modo il lavoro può essere ottimiz- 
zato e distribuito in maniera agevole e si- 
cura. 



LE NOVITÀ 

Le nuove funzionalità per la gestione dei 
contenuti includono un sostanziale mi- 
glioramento della performance, il suppor- 
to per l'editing di una tipologia di siti più 
ampia, la gestione e modifica delle imma- 
gini, l'integrazione con Microsoft Office e 
la pubblicazione automatica dei docu- 
menti in formato PDF, Flash e Flashpaper 
2. Per i Web Designers e gli sviluppatori, 
Contribute 3 rende disponibile il supporto 



a WebDAV e incorpora il motore per il ren- 
dering dei CSS {Cascade Style Sheet) di 
Dreamweaver MX 2004. Un'inedita fun- 
zionalità consente la revisione e l'editing 
del codice sorgente della pagina Web rea- 
lizzata attraverso un qualsiasi editor 
HTML, prima della pubblicazione. Per 
l'installazione è necessaria una chiave di 
attivazione che si può ottenere, via mail, 
collegandosi alla pagina HYPERLINK 
"www.macromedia.com/downloads" 
www.macromedia.com/downloads, clic- 
cando sul link try, a fianco della voce Con- 
tribute 3. 



Contribute 3 

Produttore: Macromedia 
Sul web: www.macromedia.it 
Prezzo: € 149 
Nel CD: \Contribute 3 
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Sothink SWF Decompiler 
MX2005 



di Maurizio Battista 



Un software per decompilare con facilità i filmati Flash 



Lo scorso 30 luglio, la SourceTec Softwa- 
re ha rilasciato la versione MX 2005 del 
più celebre tra i software dedicati alla ri- 
conversione dei file SWF: Sothink SWF 
Decompiler. Per chi non ne avesse mai 
sentito parlare, è un applicativo in grado di 
decompilare un filmato Flash precedente- 
mente pubblicato per il web, risalendo al 
corrispondente file FLA. Indubbiamente 
questa procedura viaggia sulla sottile linea 
di confine situata tra il lecito e la pirateria. 
Un utilizzo onesto del programma con- 




Fig. 1: L'ambiente di lavoro di Sothink SWF 
Decompiler MX 2005 



sente di recuperare propri lavori nel caso 
si siano smarriti i file nativi - una procedu- 
ra completamente legale, in grado di rime- 
diare a situazioni altrimenti irrisolvibili. 
Sarebbe illecito, invece, ricostruire un file 
sorgente altrui senza alcuna autorizzazio- 
ne. Tralasciando questi aspetti, che rien- 
trano nella complicata questione del dirit- 
to d'autore, dal punto di vista tecnico 
Sothink SWF Decompiler permette di 
importare un file SWF e smontarne i vari 
elementi. 



L'AMBIENTE 
DI LAVORO 

L'ambiente di lavoro si presenta come una 
schermata ripartita in varie sezioni. Nella 
parte superiore si trova la barra che con- 
tiene i menu File, Edit, View, Code, Option 
e Help, mentre sotto è collocata la Toolbar, 
con le icone corrispondenti alle funziona- 
lità più importanti. La sezione a sinistra 
corrisponde all' Explorer panel per naviga- 
re tra le cartelle del proprio sistema e indi- 
viduare i filmati SWF presenti. Al centro si 



trova la Preview Window, che in base alle 
impostazioni predefinite visualizza un'an- 
teprima del filmato SWF in azione come se 
fosse letto dallo Stand Alone Flash Player. 
Nella parte inferiore dell'area di lavoro, la 
sezione Information Window fornisce una 
serie di informazioni aggiuntive sull'ele- 
mento selezionato. A destra è visibile il Re- 
source Panel, nel quale appaiono, suddivi- 
si in varie cartelle, tutti gli elementi che 
compongono il filmato: immagini bitmap, 
suoni, video, simboli statici, pulsanti, clip 
filmati e script. Effettuando la selezione di 
un elemento nel Resource Panel, automa- 
ticamente la Preview Window si aggiorna 
mostrandone il contenuto all'utente: per 
esempio, se nella cartella Action selezio- 
niamo un codice, questo sarà visualizzato 
in anteprima nella sezione centrale della 
finestra di lavoro. Una volta "frammentati" 
gli elementi del file SWF, Sothink SWF De- 
compiler consente di recuperarli separa- 
tamente, per poi collocarli, uno alla volta, 
in un nuovo filmato Flash. Una procedura 
alternativa si traduce nell'uso di una fun- 
zione automatica che ricostruisce per 
intero il file sorgente con estensione .FLA. 



ESTRARRE UHI FILE MP3 
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□ Apriamo il programma e, 
adoperando V Explorer panel, 
selezioniamo il file studio3.swf 
disponibile nella cartella degli 
esempi. In alternativa, preleviamo i 
file utilizzando l'apposito pulsante 
nella barra degli strumenti di 
Explorer. 
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B Nella sezione a destra 
(Resource Panel) appare 
studio3.swf. 

Facciamo clic sulla icona a forma d 
(+) in modo da accedere alle 
sottocartelle. 

Espandiamo la cartella Sound e 
selezioniamo Soundl. 



H Premiamo il pulsante Export che si 
trova in Resource Panel: l'elenco 
dei file che il programma è in grado di 
esportare appare nella finestra Export, 
in cui possiamo scegliere dove collocare 
il file estratto. Per gli esperimenti, pote- 
te utilizzare i file presenti nel CD: 
\Codice\sorgenti fla.zip 
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In tal caso potrebbero esserci degli ele- 
menti che il programma non riesce a rico- 
struire correttamente: per esempio i nomi 
dei campi di testo dinamici e di input, e 
alcuni tipi di istruzioni. Per ovviare a que- 
sto inconveniente, si può solo procedere a 
una ricostruzione ragionata degli elemen- 
ti mancanti, basandosi sulla logica del 
progetto. Infatti, anche se non riesce a ri- 
costruire determinate istruzioni presenti 
nel codice ActionScript (in particolare le 
nuove classi), il programma le visualizza 
comunque nella Preview Window. Se In- 
ternet Explorer è il browser predefinito sul 
nostro computer, dopo che Sothink SWF 
Decompiler è stato installato, nella barra 
degli strumenti appare il pulsante Sothink 
SWF Catcher. Facendo clic sulla sua icona 
si attiva la finestra Save, che consente di 
"catturare" i filmati SWF visualizzati du- 
rante la navigazione, salvandoli in un car- 



23 


foE (i = 0; i < punti. length; i++) 


A 


24 


{ 
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attachMovie ( rr clip r ' r "clip" + i, i) ; 
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this[' r clip rr + i] . trascinai ) t 
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} ff end of fini 
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} // End of the fune ti on 
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fune ti on conversione [istanza clip) 
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f 
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vat 113 = istanza clip.x; 




32 


vac 112 ■ istanza clip.y; 




33 


var 111 = istanza clip.z; 




34 


vai 14 = Matli.sqrt( 113 * 113 + 112 * 
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if ( 113 M 0] 
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37 


var 12 = 1.570795; 
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33 


else if ( 113 != 0) 




ti) 






41 


12 - Hatn. atan( 112 / 113); 
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} fi end if 
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if ( 112 =; 0) 




44 






45 


12 = 12 + 3.141593; 
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Fig. 2: II codice mostrato nella Preview 
Window 



Products Download Order 



Fig. 3: il pulsante Sothink SWF Catcher 

tella di nostro gradimento. Grazie al pul- 
sante SWF Decompiler, inoltre, dopo il sal- 
vataggio possiamo importare il filmato 
direttamente nel programma. Nel caso in 
cui la pagina che contiene il filmato SWF 
sia inserita in una finestra creata con fa- 
vaScript, è necessario aprire una nuova fi- 
nestra vuota del browser e trascinare al 
suo interno l'icona di Internet Explorer: a 
quel punto sarà possibile fare ricorso al 
pulsante Sothink SWF Catcher. Se invece 
Internet Explorer non è il browser predefi- 
nito, per prelevare i file SWF incontrati du- 
rante la consultazione di pagine sul Web 
bisogna ricorrere a tecniche alternative 
(tra cui il classico ripescaggio dalla cache 
del computer). La versione trial di Sothink 
SWF Decompiler, che consente un perio- 
do di utilizzo di quindici giorni, non con- 
sente di ricostruire in modo automatico i 
file FLA completi e limita la consultazione 
a un numero massimo di due soli script. 



LE CONTROMISURE 

Per concludere, vediamo quali contromi- 
sure abbiamo a disposizione se vogliamo 
impedire che qualche "malintenzionato" 



adoperi il decompilatore per saccheggiare 
i nostri SWF. Le strade percorribili sono 
poche. Sicuramente non è possibile pro- 
teggere in alcun modo i contenuti grafici e 
sonori, anche se il file è esportato con l'op- 
zione Proteggi da importazione. Gli unici 
due espedienti che si possono tentare so- 
no i seguenti: offuscare codice in modo 
da renderlo meno leggibile oppure ricor- 
rere a un uso intensivo di classi associate 
ai clip filmati. Come tutti gli utenti di Flash 
sanno, a partire dalla versione MX 2004 è 
stata introdotta la possibilità di creare file 
con estensione .AS esterni che funzionano 
in modo simile alle classi java: se si prova a 
decompilare uno di questi file, pur visua- 
lizzando il codice della classe non si riesce 
a riprodurre un file FLA completo e fun- 
zionante. Questa soluzione potrebbe non 
risolvere del tutto il problema. Infatti, se 
chi usa il decompilatore è un programma- 
tore esperto, leggendo le classi mostrate 
nella sezione centrale potrebbe ricrearle 
per il nuovo FLA esportato. Tuttavia, poi- 
ché non è un'operazione semplice o im- 
mediata, diventa un modo per rendere la 
vita difficile a quanti decidessero di usare 
Sothink SWF Decompiler con un nostro 
lavoro. 



I 



Sothink SWF 
Decompiler MX 2005 

Produttore: SourceTec Software 
Sul web: www.sothink.com 
Prezzo: $ 79.99 
Nel CD: swfdec.zip 
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RICOSTRUIRE UHI FILE FLA 




Q Apriamo il file studio3.swf. 
Se il programma riesce a esegui- 
re in anteprima tutte le funzioni 
delI'SWF, abbiamo già un buon indizio 
sull'esito positivo dell'esportazione 
automatica. In alcuni casi, Sothink SWF 
Decompiler non riesce a esportare un 
FLA funzionante. 
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H Selezioniamo il pulsante 
Export FLA, (ìa seconda icona 
da sinistra nella Toolbar). 
Così facendo il programma apre la 
finestra Salva con nome, nella 
quale per impostazione predefinita 
crea un file FLA chiamato 
~studio3.fla. 



SWF Decompiler 






Yes No 




H Appare una finestra in cui ci 
viene chiesto se vogliamo 
aprire il file appena salvato con 
Flash. Facendo un raffronto, 
notiamo che Sothink SWF 
Decompiler rinomina i simboli 
della libreria e sostituisce i 
commenti presenti nel codice. 



http://www.ioprogrammo.it 



Novembre 2004/ 13 ► 



SOFTWARE SUL CD 



Tool di sviluppo 



Xamlon 0.9 

Prova in anteprima XAML 

Lo sviluppatore Paul Colton ha messo a di- 
sposizione un software xamlon (www. 
xamlon.com) che consta di due strumenti: 
Visual Designer for Visual Studio .NET 
2003 e XamlPad. Il primo mette a disposi- 
zione un plug-in per Visual Studio .NET 
2003, che permette di salvare l'interfaccia 
grafica di un'applicazione in linguaggio 
XAML; il secondo implementa, invece, 
una sorta di Notepad per scrivere e testare 
script XAML; in aggiunta consente finan- 
che di convertire file SVG e C# in linguag- 
gio XAML nativo. L'installazione del pac- 
chetto prevede che sul proprio sistema 
operativo sia correttamente installata la 
versione 1.1 del .NET Framework. 

Code Counter Pro 1.2 

Un contachilometri per chi 
programma! 

Una comoda applicazione che consente 
a noi programmatori di quantificare il 
lavoro che abbiamo svolto o stiamo svol- 
gendo. Code Counter si occupa di valu- 
tare il numero di righe, spazi bianchi, 
commenti e quant' altro sia interessante 
per effettuare statistiche sul codice. I lin- 
guaggi supportati sono numerosi: C/C++, 
Java, Delphi/ Pascal, VB, PHP ASP ed altri 
ancora, ed è possiblile effettuare analisi 
anche su porzioni di testo che non siano 
riconducibili a codice sorgente. 
ccountp.exe 

Snippet Compiler 1.11 

Compilatore per snippet in C# 

Quante volte vi è capitato di dover genera- 
re una soluzione .NET solo per testare po- 
che righe di codice? Snippet Compiler evi- 
ta proprio questo genere di "fastidio": at- 
traverso questo piccolo e leggerissimo IDE 
potremo compilare le nostre porzioni di 
codice (in C#, VB.NET e ASP.NET) senza 
dover lanciare il più potente e ingombran- 
te Visual Studio. Benché si tratti di una rea- 
lizzazione "artigianale" Snippet Compiler 
compie il suo lavoro alla perfezione. 
SnippetCompiler.zip 

ColorCache 2.0.1 

Un aiuto nella scelta dei colori 

Un tool completo e semplice da utilizzare 
che ci aiuta nel comporre l'interfaccia 
delle nostre applicazioni. Possiamo indivi- 
duare (con un "contagocce") il colore pre- 
sente in una zona qualsiasi dello schermo 



e, a partire da un qualsiasi colore, possia- 
mo farci indicare quali sono i complemen- 
tari, i più simili, quelli che maggiormente 
contrastano e così via. Versione di prova 
valida trenta giorni. 
cche2010.exe 

NeuroSolutions 4.32 

Progettare e simulare reti neurali 

Un interessante esempio di come si possa 
arrivare, per via grafica, alla realizzazione 
di complesse reti neurali. L'interfaccia gra- 
fica è molto semplice e piacevole da uti- 
lizzare: attraverso un ampio utilizzo di ele- 
menti modulari, NeuroSoluions riesce a 
diluire la difficoltà insita in progetti di que- 
sto tipo. Numerosi sono i grafici con cui è 
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possibile visualizzare l'attività della rete e 
gli esempi disponibili aiutano anche il 
profano ad entrare nel mondo delle reti 
neurali con relativa semplicità. Ottimo il 
Wizard che consente di creare una libreria 
DLL a partire da una rete progettata con 
NeuroSolution. Versione dimostrativa vali- 
da sessanta giorni. 
nsinstall.exe 

WhosOn 3.1 

Statistiche per i tuoi siti 

WhosOn consente di monitorare l'attività 
sui siti che gestiamo, differenziando fra la 
presenza di spider e quella di utenti on- 
line. Analisi statistiche basate sulle serie 
storiche consentono un migliore lettura 
dei dati e, grazie alla chat integrata, è pos- 
sibile dialogare a distanza con gli ammini- 
stratori dei server remoti. Interessante la 
funzione di Hacker detection che ci avvisa 
in caso di accessi "anomali" al server. 
Versione dimostrativa valida trenta giorni. 
WhosOn30.exe 

Advanced PDF to HTML 
Converter 1.6 

Converte documenti PDF in HTML 

Molto efficace questa utility che si occupa 
di convertire documenti PDF in pagine 
HTML, preservandone la formattazione e 
consentendone la fruizione via Web. Non 



richiede la presenza di Acrobat Reader per 
funzionare e può essere istruito per effet- 
tuare più conversione in batch. Versione 
dimostrativa: su tutte le pagine prodotte è 
impresso unWatermark. 
pdf2html_1_6_setup.exe 

Fastream NETFile 
FTP/Web Server 6.9.5 

Server FTP e Web in un pacchetto 

Un server gratuito e decisamente spartano 
che consente l'amministrazione da remo- 
to grazie ad una semplice interfaccia grafi- 
ca. Autenticazione, impostazione differen- 
ziata della velocità di upload e di down- 
load, definizione delle quote di Storage, 
gestione dinamica dei DNS: sono alcune 
delle caratteristiche di questo piccolo e 
valido strumento. Gratuito. 
NetFileServer.exe 

Deep Log Analyzer 1.4 

Per raccogliere statistiche sul Web 

La visualizzazione per via grafica delle sta- 
tistiche è il punto di forza di Log Analyzer: 
il numero e la complessità delle diverse 
analisi possibile consentono di avere in 
ogni momento quadro aggiornato del- 
l'accesso ai nostri siti. I raggruppamenti 
che abbiamo a disposizione vanno a defi- 
nire un ampio campionario di possibili re- 
port mentre la grafica evoluta consente 
una efficace interattività con l'utilizzatore. 
Versione valida venticinque giorni. 
dlatrial.exe 

Xlight FTP Server 1.6c 

Un server FTP tutto compreso 

Molto semplice da installare e da utilizza- 
re, questo server FTP non rinuncia a fun- 
zionalità avanzate come il supporto per 
ODBC e per SSL. I numerosi settaggi com- 
prendono la possibilità di definire gruppi 
di utenti cui riservare speciali aree, l'op- 
portunità di definire "banned" alcuni IP 
insieme ad una lunga serie di regole di si- 
curezza. Versione di valutazione valida 
trenta giorni. 
setup.exe 

XML:Wrench 1.2 

Manipolazione di file XML 

Un editor XML decisamente spartano che 
fa della semplicità il suo punto di forza. 
Con XML:Wrench è possibile manipolare 
anche file HTML e XHTML, il tutto senza 
inutili fronzoli e con un'interfaccia che 
piacerà agli utenti più smaliziati e meno 
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avvezzi alle funzionalità che rallentano la 
macchina prima ancora di velocizzare il 
lavoro dello sviluppatore! Sono comunque 
disponibili alcune indispensabili funzio- 
nalità come l'auto-completion. 
La migliore caratteristica: è gratuito. 
xmlwrench-v1 20.exe 

Resou ree Standard 
Metrics 6.52 

Analizza il tuo codice Java, C e C++ 

Resource Standard Metrics (RSM) offre un 
ricco ventaglio di analisi utili a definire la 
qualità del tuo codice. E possibile verifica- 
re che il codice che produciamo rispetti ol- 
tre cinquanta regole comunemente accet- 
tate come indice di qualità. La precisione e 
la velocità di questo prodotto hanno fatto 
sì che fosse scelto da oltre 1000 aziende in 
tutto il mondo. Versione di prova, analizza 
un massimo di dieci file. 
rsm.zip 

TextPipe Pro 7.0.7 

Manipolazione di testi 

Una eccellente soluzione per quella vasta 
schiera di sviluppatori che vanno dai pro- 
grammatori ai web-designer e che ha ne- 
cessità di portare a termine complesse 
operazioni di manipolazione su file te- 
stuali. TextPipe include moltissimi filtri 
utili a ottimizzare l'aspetto di codice sor- 
gente scritto in qualsiasi linguaggio. Sofi- 
sticato nelle funzionalità ma semplice da 
utilizzare. È stato rinnovato il Wizard che 
guida alla ricerca testuale all'interno di tag 
HTML. Trenta giorni di prova. 
textpi pepro-cn .exe 

WebCompiler 2.1.16 

Da HTML a EXE: ora e facile! 

Se vi trovate nella necessità di pubblicare 
un e-book, un manuale o la demo di un 
sito, questo è il prodotto che fa per voi: 
WebCompiler riesce a convertire, in breve 
tempo e con un intervento minimo da 
parte dello sviluppatore, le pagine HTML 
di un sito in una completa applicazione 
stand-alone. Con il supporto per fava- 
Script, Flash e cookies, offre una intelli- 
gente soluzione ad un ampio ventaglio di 
problematiche. 
x2nwc.zip 

Enterprise Architect 4.1 

Per sviluppare e documentare 
software Object Oriented 

Un completo ambiente visuale per svilup- 




pare e manutenere software object orien- 
ted. Con il pieno supporto di UML 2.0, e di 
tutti i diagrammi contemplati dallo stan- 
dard. Enterprise Architect consente di 
verificare l'integrità delle dipendenze fra i 
vari oggetti che compongono i nostri pro- 
getti e permette di modellare la gerarchia 
delle classi, sia staticamente sia dinamica- 
mente. Con Enterprise Architect è possibi- 
le documentare con precisione e rapida- 
mente qualsiasi progetto di sviluppo soft- 
ware, curando tutte le fasi del ciclo di vita 
del progetto: dalla ideazione alla confezio- 
ne finale, passando per la fase di test e del 
controllo sui cambiamenti. 
Versione di valutazione valida trenta 
giorni. 
easetup.exe 

Meuron PE 
Disassembler 1.0 b3 

Disassemblare DLL, OCX ed EXE 

Un tool che, attraverso una interfaccia 
visuale, consente di leggere il codice di 
librerie DLL e componenti OCX, oltre che 
dei file eseguibili Win 32. La lettura del 
codice è aiutata dalla struttura ad albero 
che visualmente viene resa sullo schermo. 
Versione dimostrativa valida trenta giorni. 
neuronpedisassembler.zip 

JDebugTool 3.7 

Un debugger Java full optional! 

Un debugger stand alone costruito sulla 
base della JPDA, fava Platform Debugger 
Architecture. L'interfaccia grafica ed un 
Help ottimamente strutturato consentono 
un rapido utilizzo del tool. Tra le funzioni 
segnaliamo: debug remoto, debug multi- 
thread, modifica delle variabili "al volo", 
visualizzazione delle classi attualmente 
caricate, valutazione dei toString, monito- 
raggio dell'occupazione di memoria, sin- 
cronizzazione con gli eventi di load e 
unload delle classi. In questa versione si 
apprezza particolarmente la velocità di 
esecuzione. Demo valida quindici giorni. 
debugtool sdk14.jar 



Neuron Developer 
Studio 1.0b3 

Disassembla file .CLASS e .EXE 

Un tool che aiuta lo sviluppatore nella 
gestione delle risorse a sua disposizione. 
Eseguibili fava e Win32 possono essere 
esplorati attraverso una interfaccia grafica 
che ne evidenzia gli oggetti e le classi che 
li compongono. Interessante anche il 
supporto verso i database che possono 
essere interrogati via ODBC. Versione 
dimostrativa valida trenta giorni. 
neuronshell.zip 

Batch File Compiler 2.0 

Trasformare un file batch in EXE 

La funzionalità principale di questa appli- 
cazione è tradurre in .EXE qualsiasi file 
batch (.bat). In aggiunta, abbiamo la pos- 
sibilità di sfruttare alcune commodity co- 
me l'utilizzo dei colori e l'esecuzione di 
semplici operazioni matematiche. L'inter- 
faccia grafica è quanto di più semplice si 
possa immaginare. All'atto della compila- 
zione, è possibile scegliere come target il 
DOS 6.0 o Windows. Versione di prova, 
limitazioni su comandi utilizzabili. 
bfcped.exe 

CASE Studio 2 2.17 

Diagrammi Entità-Relazione 

Uno strumento che consente di pro- 
gettare qualsiasi database attraverso i 
Diagrammi Entità-Relazione. L'interfac- 
cia grafica consente di avere il pieno con- 
trollo del progetto ed è possibile generare 
il relativo DB per tutti i più diffusi DBMS: 
Oracle, DB2, MSSQL, Access, Sybase, In- 
terBase, Firebird, MaxDB, MySQL, e Post- 
greSQL. I dettagliati report in HTML si ri- 
velano di grande utilità all'atto della do- 
cumentazione di un progetto. Versione di- 
mostrativa limitata nelle funzionalità. 
casestudio.zip 

Code Charge Studio 2.3 

Un contachilometri per il codice! 

Una delle migliori soluzioni per la crea- 
zione di applicazioni Web database-dri- 
ven per via visuale. Davvero ampio il sup- 
porto per tutti i più diffusi database e 
qualsiasi server Web. CodeCharge Studio 
rappresenta un'ottima soluzione per svi- 
luppatori con qualsiasi esperienza (Ac- 
cess, progettisti Web, ecc.) per fare il gran- 
de salto e lanciarsi nella realizzazioni di 
complete soluzioni e-business. 
CCStudio2_3.exe 
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Dev-C++ 5.0 Beta 9 

Un ottimo JDE 

Ambiente integrato per lo sviluppo di 
applicazioni C/C++ distribuito con licenza 
Open Source GNU GPL. 



L 




Il programma utilizza Mingwn, port del 
potente compilatore GCC (GNU Compiler 
Collection), ma può essere utilizzato con 
Cygwin o qualsiasi altro compilatore basa- 
to su GCC. Dev-C++ consente di creare 
eseguibili Win32 come applicazioni GUI, 
console, librerie statiche e DLL. Gratuito, 
mediante l'installazione è possibile impo- 
stare come lingua l'italiano. 
devcpp4990setup.exe 

Mono 1.0.1 

Framework .NET in versione Open 
Source 

Il progetto Mono è nato da un' iniziativa 
Ximian (oggi è appoggiato anche da No- 
vell) con l'obiettivo di creare una versione 
Open Source per Unix della piattaforma di 
sviluppo Microsoft .NET, in maniera tale 
da permettere agli sviluppatori Unix di rea- 
lizzare applicazioni .NET cross-plattform. 





Mono include un compilatore per lin- 
guaggio C#, un ambiente runtime chiama- 
to Common Language Runtime (CLR) per 
il Common Language Infrastructure (CLI) 
e numerose librerie di classi completa- 
mente compatibili con .NET 
mono-1.0.1-gtksharp-1.0-win32-0. 5.exe 

Eclipse 3.0.1 

Il massimo per lo sviluppo Java 

Il progetto Eclipse, inizialmente di prò- 



— 

=StSr 

"S3£™ ■— — — 



prietà IBM e da questa donato alla comu- 
nità open-source è essenzialmente una 
raccolta di vari tipi di sottoprogetti che in 
realtà insieme formano, più che un softwa- 
re per lo sviluppo, un framework per la 
creazione di ambienti integrati di sviluppo 
per qualunque linguaggio e piattaforma. 
Ma la ragione del successo di Eclipse risie- 
de nell'IDE per la creazione di applicazioni 
Java che, offerto di fatto come esempio di 
uso del framework che Eclipse mette a 
disposizione, è riuscito a imporsi come 
prodotto di alta qualità, pur essendo com- 
pletamente gratuito. L'installazione del 
prodotto è veramente molto semplice. Do- 
vete assicurarvi che sia installato sulla vo- 
stra macchina un JDK pari o superiore al 
1.4.1, dopodiché potete unzippare file 
direttamente dove volete installare il pro- 
dotto. . . finito! Tra i vari file estratti trovere- 
te l'eseguibile eclipse.exe da lanciare per 
fare partire l'IDE. 
eclipse-platform-3. 0.1-win32.zip 

mysql-4.1.5 

Il più diffuso database server 
Open Source 

MySQL è diventato in breve tempo il data- 
base server Open Source più popolare, con 
il tasso di crescita più elevato proprio 
all'interno delle industrie. Questo è dovuto 
alla volontà degli sviluppatori di fornire un 
prodotto efficiente e meno complicato dei 
rivali, che garantisce un TCO notevolmen- 
te ridotto. MySQL offre numerosi vantaggi: 
affidabilità e prestazioni elevate prima di 
ogni altra cosa, mentre la sicurezza è sem- 
pre di prim'ordine, grazie al lavoro di test 
svolto dalla comunità Open Source. Esisto- 
no numerose versioni del database server: 
Max DB, cluster e a breve una versione em- 
bedded. Inoltre, sono disponibili tutta una 
serie di strumenti che migliorano l'effi- 
cienza e la produttività: 

• MySQL Control Center (MySQLCQ un 
client grafico per la gestione dei dati; 

• MySQL Administrator un'interfaccia di 



amministrazione visuale per l'ammini- 
strazione del server MySQL; 
• MySQL Connector/J e MySQL Connec- 
tor/ODBC per la connessione attraverso 
driver JDBC (Java) e ODBC. 

mysql-4.1 .5-gamma-win.zip 

DEVLIB 1.4 

Il massimo per creare applicazioni 
multimediali. 

Un framework object-oriented realizza- 
to completamente in C++ con l'obietti- 
vo di fornire agli sviluppatori un sofisti- 
cato strumento per la creazione di pro- 
dotti multimediali: giochi, screensaver, 
applicazioni grafiche (2D e 3D), player 
audio e video, ecc. DevLib è compatibi- 
le con Bloodshed C++ e Microsoft Visual 
C++. 
DevLib-SDK-1. 4.zip 

jEdit 4.2 

Un editor per programmatori Java 

Realizzato completamente in Java, jEdit 
è un completo editor di testi per pro- 
grammatori disponibile per numerose 
piattaforme tra cui MacOS X, OS/2, 
GNU /Linux (Unix) e Windows. Il pro- 
gramma, per l'immediatezza e la sempli- 
cità di utilizzo, è molto usato per scopi 
didattici e da programmatori non profes- 
sionisti. 




jEdit integra un completo linguaggio di 
macro e dispone di un'architettura facil- 
mente estensibile mediante l'utilizzo di 
numerosi plugin facilmente gestibili tra- 
mite il "plugin manager". Inoltre, nono- 
stante sia stato creato per sviluppare pre- 
valentemente applicazioni Java, dispone 
di funzionalità per indentare ed eviden- 
ziare il codice per oltre ottanta linguaggi 
di programmazione. Per poter installare 
e utilizzare jEdit è necessario disporre 
del J2SDK 1.3 o 1.4 
jedit42install.exe 
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Demo: come unire programmazione e arte 

niella Demoscene 

Cera una volta la demo, esibizione di capacità tecniche e artistiche 
di talentuosi, spesso geniali, programmatori, grafici e musicisti. 
Oggi l'esistenza di questa élite è minacciata da Werkkzeug 



Forse non tutti hanno avuto il piacere di ammi- 
rare gli effetti spettacolari che compongono 
una demo, dunque, prima di procedere, defi- 
niamo alcuni concetti fondamentali per la com- 
prensione dell'articolo. Una demo è una presenta- 
zione multimediale non interattiva, caratterizzata 
da grafica 2D/3D generata in tempo reale, di solito 
sincronizzata con una colonna sonora. Immaginate 
un video, costituito da effetti speciali di forte impat- 
to visivo, ottenuto rigorosamente via codice! L'in- 
sieme delle persone coinvolte nella creazione di 
demo e le loro attività, in particolare i demoparty, 
formano la Demoscene, in breve Scene o Scena. 
A questo punto, in molti potrebbero chiedersi per- 
ché sprecare del tempo prezioso nello sviluppo di 
applicazioni apparentemente inutili. La risposta è 
semplice: oltre a rappresentare una forma d'arte 
che permette di fondere tecnologia e fantasia, la 
programmazione di demo è un hobby in grado di 
contribuire alla notorietà degli sviluppatori. Ogni 
produzione ha bisogno di diversi sceners, ovvero 
grafici, musicisti e programmatori organizzati in 
gruppi, anche se a volte la demo è frutto del genio di 
una singola persona. I vari demogroup si danno 
appuntamento in eventi chiamati party, solitamen- 
te tenuti nei paesi dell'Europa settentrionale, per 
presentare i propri capolavori ad una platea di col- 
leghi e semplici curiosi. Potete pensare ad un demo- 
party come ad un mix tra una festa in cui scorrono 
fiumi di birra ed una serie di competizioni che pre- 
vedono premi per i progetti migliori. 
Nell'introduzione, ho accennato ad una élite, difatti 
solo un ristretto numero di individui ha doti artisti- 
che e conoscenze tecniche adeguate all'implemen- 
tazione di una demo di successo. Basti pensare che 
tra i requisiti essenziali bisogna annoverare la com- 
pleta padronanza di: un linguaggio di programma- 
zione (i più usati sono C/C++, Assembly, Pascal, di 
rado Java) , una libreria grafica tra OpenGL e DirectX 
se si programma in ambienti Windows, concetti 
matematici avanzati. . . 

I demogroup più influenti nella Demoscene rila- 
sciano demo di qualità eccezionale anche grazie a 
programmi autoprodotti, gelosamente custoditi 



negli hard-disk più bui e polverosi. Per nostra fortu- 
na, i membri del celebre gruppo Farbrausch hanno 
deciso di rendere pubblico Werkkzeug, il tool che ha 
consentito loro di proporre le produzioni più spet- 
tacolari degli ultimi anni. Finalmente i comuni 
mortali potranno smettere di chiedersi "ma come 
accidenti fanno a tirar fuori cose simili?!?" e cimen- 
tarsi nella programmazione di demo per magari 
figurare tra i vincitori di qualche contest internazio- 
nale! 



LO STRUMENTO 

Werkkzeug è un programma molto controverso per- 
ché da una parte consente, anche al neofita, di otte- 
nere in breve tempo effetti stupefacenti, dall'altra 
mina l'innovazione, lo spirito di gruppo della 
Demoscene e abbatte il mito romantico degli sma- 
nettoni in grado di sfruttare fino al limite le risorse 
hardware. Essendo poco interessati a questo genere 
di polemiche concentriamo la nostra attenzione 
sulle caratteristiche e sul funzionamento dello stru- 
mento in questione. I membri del gruppo Far- 
brausch considerano improponibile una documen- 
tazione completa del programma a causa della sua 
complessità. 

Questo articolo, per ovvi motivi, non può trattare 
esaustivamente il prodotto, si propone quindi di 
fornire una descrizione introduttiva. Werkkzeug ha 
bisogno delle librerie DirectX 9.0a per operare cor- 
rettamente, assicuratevi di aver aggiornato il vostro 
sistema prima di puntare l'indice contro ipotetici 
bug. Lo strumento può essere visto come un "lin- 
guaggio di programmazione visuale", in stile 
Labview, che permette agli utenti di concentrarsi 
sulla creatività e sulla resa finale della demo. Tra le 
varie caratteristiche di Werkkzeug è d'obbligo sotto- 
lineare: 

• Un motore 3D potente e veloce; 

• Il supporto per svariati tipi di file: XSI (Softima- 
ge), LWO (modelli Lightwave), JPEG, XM (mo- 
duli musicali in formato eXtended Module), etc. 
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1. Questa finestra mostra 
l'anteprima in realtime 
dell'effetto o dell'intera de- 
mo. Per testare la resa di un 
aggregato di operatori è 
necessario selezionare un 
blocco e premere il tasto s 
(show). Potenza del "what 
you see is what you get"! 



2. La seconda finestra di anteprima consente di 

esaminare un'altra porzione della demo al fine di 

eseguire un confronto per un eventuale perfezionamento 

dell'effetto. La combinazione di tasti che attiva 

l'anteprima secondaria è ctrl+s, non dimenticate però di 

selezionare l'operatore da visualizzare. 



4. La lista delle pagine serve 
per dare una struttura alla 
propria demo, avete presen- 
te i diversi moduli che com- 
pongono un'applicazione 
tradizionale? Bene, non si 
tratta di un concetto molto 
diverso. Le pagine contengo- 
no gli insiemi di operatori e 
dovrebbero essere create 
seguendo un criterio coeren- 
te. Se la demo è composta di 
tre scene è opportuno, ma 
non obbligatorio, definire 
tre pagine chiamate rispetti- 
vamente Scena 7, Scenai e 
Scena3 ed una pagina deno- 
minata Main. All'interno di 
una pagina il programmato- 
re andrà a sovrapporre gli 
operatori creando così delle 
subroutine. 



PER SAPERNE 
DI PIÙ 



Se avete voglia di fare 
un viaggio all'estero vi 
consiglio di non perde- 
re i seguenti party; sui 
relativi siti trovate 
tutte le informazioni 
logistiche, i regolamen- 
ti ed ovviamente i pro- 
getti presentati nelle 
edizioni precedenti: 

http://www.assembly.org 

http://www.thepartv.dk 

http://www.takeover.nl 

http://www.gathering.org 

http://ms.demo.org 




3. Ogni operatore è dotato 
di una serie di parametri, 
apportando delle modifiche 
ai valori di tali parametri si 
ottiene, in tempo reale, il 
risultato desiderato nella 
finestra di anteprima. Clic- 
cando sulla A (animazione) 
posta vicino ad alcuni dei 
parametri si può stabilire il 
comportamento dinamico 
della proprietà. A titolo di 
esempio è possibile ruotare 
un oggetto attivando l'ani- 
mazione del parametro ro- 
tate ed utilizzando un ope- 
ratore "channel anim". Non 
vi preoccupate, tutto diven- 
terà più chiaro in seguito! 



5. In questa area vanno disposti i vari blocchi, il colore del blocco ci aiuta 
ad individuare la classe di appartenenza dell'operatore. La lista degli ope- 
ratori è accessibile direttamente per mezzo dei tasti che vanno da a 4 
(Fig. 3). L'ultima colonna delle liste è in comune alle varie classi. Con il 
pulsante destro del mouse si visualizza un menu contestuale ricco di voci. 
Potete modificare la visuale tenendo premuti il tasto b ed il pulsante 
destro del mouse mentre spostate il puntatore. Il tasto f invece apre una 
finestra di ricerca, se cliccate sul pulsante Wame e selezionate l'opzione 
Bugs consulterete la lista degli errori potenziali. 

Fig. 1: Riconosciamo le principali aree dell'interfaccia 



6. In basso ci sono i controlli 
temporali quali la timeline ed 
i pulsanti per la riproduzione 
della demo. Non trascurate 
l'indicazione dei frame per 
secondo (FPS), al diminuire di 
tale valore corrisponde un 
rallentamento della demo. 
Una sottile linea rossa 
verticale evidenzia il tempo 
corrente della riproduzione, 
dopo aver premuto il 
pulsante play può essere 
fascinata liberamente. La 
riproduzione della demo è 
riawiabile tramite il pulsante 
etichettato re (rewind). 




Fig. 2: Andamento temporale della demo. La 
visualizzazione è attivata/disattivata con il tasto 
e (premuto nell'area contenente gli operatori) 



Un generatore di texture e forme 3D; 
I controlli temporali e lo spline editor; 
L'elaborazione delle immagini, gli effetti specia- 
li (FX) ed un potente sistema particellare; 
La gestione degli effetti tramite pixel shader; 
Un numero veramente notevole di operatori 
parametrizzabili; 

La presenza di un "compilatore" ottimizzato; 
Un ambiente di sviluppo completamente wysi- 
wyg. 

L'ambiente mette a disposizione un ampio numero 
di blocchi elementari, ma altamente configurabili, 
chiamati operatori. Tali operatori, graficamente, 
corrispondono a dei rettangoli colorati, sono para- 
gonabili alle parole chiave 
di un linguaggio e devono 
essere combinati in modo 
opportuno per ottenere del- 
le routine. Sovrapponendo 
gli operatori si definisce una 
connessione tra essi e di 
conseguenza la struttura 
della demo, vi faccio notare 
che le operazioni vengono 



eseguite dall'alto verso il basso ed una linea rossa 
evidenzia le sovrapposizioni incompatibili. Dopo 
aver analizzato l'interfaccia utente dell'ambiente 
Werkkzeug (Fig. 1) vedremo degli esempi concreti di 
routine create disponendo uno sull'altro diversi 
operatori. L'interfaccia è formata essenzialmente da 
sei aree a cui faremo spesso riferimento. L'interfac- 
cia utente è formata anche da altre finestre, in parti- 
colare segnalo la visualizzazione temporale (Fig. 2) 
e lo spline editor (Fig. 4). Si noti che quasi tutte le 
funzioni del programma sono facilmente raggiungi- 
bili grazie ad un complesso di scorciatoie da tastie- 
ra. Se la finestra attiva è quella identificata dal nu- 
mero 5 allora la pressione del tasto e mostra/na- 
sconde la sequenza temporale della demo. Tale se- 
quenza è modificabile trascinando i blocchi tane 
oppure operando direttamente sui singoli parame- 
tri della zona 3. Quando due o più tempi coincido- 
no il colore dei blocchi time incriminati passa da 
grigio a rosa. Lo spline editor risulta accessibile da 
ogni operatore di tipo Camera mediante tasto g, si 
tratta di uno strumento potente ma purtroppo poco 
intuitivo. L'editor consente di stabilire i movimenti 
non-lineari della camera: i vostri primi esperimenti 
potranno tranquillamente farne a meno. 
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OPERATORI 



Gli operatori sono classificabili in cinque categorie 
(Fig.3): 



mise. 


Verte, 


Tra ristorni t 


Extrude e 


Select CuDe 
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bitmap 1 


Cube q 


Transform Ex 
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Load 
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mesh 2 
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Fig. 3: Con i tasti OS si accede alle diverse classi di 
operatori. Memorizzate le scorciatoie da tastiera! 

• Mise - 1 blocchi strettamente necessari per im- 
plementare una demo in Werkkzeug sono: De- 
mo, Metronome e Time. Vi accorgerete presto 
che non si può prescindere dalla conoscenza de- 
gli operatori Camera, XM, ChannelAnim, Load e 
Store. Anche i commenti al codice, se così voglia- 
mo definirlo, sono dei rettangoli colorati. 

• Bitmap - Questi operatori sono utilissimi nella 
creazione di immagini bidimensionali utilizza- 
bili come texture. Giovo, Pixels, Clouds, BlureAdd 
sono tra i blocchi usati più comunemente. 

• Mesh - Oggetti tridimensionali e relativi mate- 
riali trovano spazio nella categoria mesh. Com- 
plesse forme 3D vengono generate con procedu- 
re di estrusione, moltiplicazione, randomizza- 
zione, trasformazioni generiche oppure operan- 
do su modelli creati con software di model- 
lazione quali Softimage, Lightwave o l'economi- 
co Milkshape 3D. 

• Material - Gli operatori Material e Material 
Input (classe mesh) definiscono le proprietà del 
materiale utilizzato nel rendering dell'oggetto. 

• Model - Particle è un operatore molto interes- 
sante perché permette di simulare qualsiasi 
emettitore di particelle: fuochi d'artificio, fonta- 
ne, nuvole, esplosioni, etc. Altri operatori da non 
trascurare sono: Add, Transform, Font e Tight. 

Werkkzeug viene distribuito con un'ottima guida, 
adatta sia come introduzione all'ambiente sia come 
riferimento per i programmatori, se così vogliamo 
definirli, esperti. Ogni categoria di operatori merite- 
rebbe un articolo intero, dunque l'unico modo di im- 
parare ad utilizzare programma è partire dalla 
guida. Il file da caricare è chiamato tutorial 133.kl, se 
conoscete l'inglese vi consiglio vivamente di studiare 
il tutorial e di smanettare con gli operatori per pren- 
dere confidenza con programma. Nella parte re- 
stante dell'articolo saranno messe in evidenza le fun- 
zionalità più rilevanti con un approccio hands-on. 



LA PRIMA DEMO 

In generale, primo passo consiste nel creare un nu- 



mero di pagine almeno uguale alle scene presenti 
nella demo da implementare. Per fare ciò dobbiamo 
premere il tasto a dopo esserci assicurati che l'area 
attiva sia la finestra della pagine. L'area 3 è dotata di 
un menu contestuale per la gestione delle pagine. Il 
nostro progetto, per non complicare troppo le cose, 
sarà contenuto in un'unica pagina in cui posizione- 
remo tutti gli operatori. Ogni blocco ha una linea 
verticale sulla destra, cliccandovi sopra e spostando 
il mouse mouse verso destra o sinistra si ridimen- 
siona l'oggetto. I blocchi 
possono essere spostati 
singolarmente o in gruppo 
previa una selezione simi- 
le a quella delle icone in 
Windows Explorer. Il pro- 
gramma offre anche la 
possibilità di tagliare, co- 
piare e incollare gli opera- 
tori selezionati, premendo 
x, e, v (senza CTRT). Poniamoci adesso l'obiettivo di 
creare una scena che mostri una struttura 3D in 
movimento all'interno di una nebulosa (Fig.l): 

• Abbiamo bisogno di diversi operatori della classe 
Bitmap per generare un materiale. Disponiamo i 
blocchi Pixels (con Count = 4096), Glow, Add, Text e 
Add come in (Fig.5) e aggiungiamo un operatore 
Material chiamandolo Materiale. 

• L'oggetto 3D viene creato partendo da un banalis- 
simo cubo attraverso un procedimento di estrusio- 
ne con Count = 5 ed un minimo di rotazione. Il 
modello appare vuoto perché l'operatore Options 
ha il parametro Generate posto a "ThickTines" ovve- 
ro "Tinee Spesse". 

• L'effetto nebulosa è dovuto a due blocchi Particle 
con la proprietà Sprite Material impostata al mate- 
riale precedentemente generato. I due sistemi par- 
ticellari rappresentati dagli operatori Particle fun- 
zionano in parallelo perché sono combinati en- 
trambi con l'oggetto 3D per mezzo del blocco Add. 
Modificando leggermente i diversi parametri dell'o- 
peratore Particle si ottengono effetti molto interes- 
santi. 

• Il movimento di camera è gestito da due trasforma- 
zioni distinte: una traslazione ed una rotazione. Il 
blocco Camera offre un'ampia gamma di parametri, 
dalle distanze di clipping alla modalità di vista pas- 
sando per le spline e l'integrazione con gli effetti 
speciali (operatore FX) . Il programma può funziona- 
re anche in modalità "modifica diretta": selezionate 
una delle due anteprime e nel relativo menu ViewX 
spuntate la voce Tink 
Edit. Tutte le modifiche 
apportate all'anteprima 
si rifletteranno sui para- 
metri dell'oggetto. 

• Werkkzeug implementa 





Fig. 4: Lo spline editor, uno strumento potente ma 
poco intuitivo. È accessibile con il tasto g da ogni 
operatore Camera 




^ SUL WEB 



Se avete bisogno di 
risorse multimediali 
quali moduli musicali 
o modelli 3D seguite 
i link: 

www.modarchive.com 
www.dc5.org/demodulate 
Due siti da cui è pos- 
sibile scaricare moduli 
musicali, alcuni file so- 
no coperti da diritti 
d'autore. 

www.modpluq.com/ 

modpluq 

Provate questo tracker 

per mettere alla prova 

il musicista che è in 

voi. 

www.swissquake.ch/ 
chumbalum-soft 
Modellatore 3D, vi 
ricordo che 

.Werkkzeugl supporta i 
formati XSI e LWO. 
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Fig. 5: Il "sorgente" della nostra prima demo 
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APPROFONDIMENTI 



www.theprodukktcom 

È il sito ufficiale del 

"prodotto". 

www.scene.org 
Un punto di riferimen- 
to per la Demoscene: 
novità, demo, eventi... 

rvttp://smeschini.altervista 

.org 

Guide, esempi ed altro 

materiale interessante. 

www.vectronix.org/wbb 

Un forum con trucchi, 

tutorial ed esempi. 



il concetto di subroutine con gli operatori Load e 
Store, gli unici caratterizzati da bordi arrotondati. Ad 
intere sequenze di operatori viene assegnato un no- 
me dal blocco Store, la chiamata della subroutine è 
indipendente dalla pagina in cui essa è definita e av- 
viene mediante l'operatore Load. Nel nostro esem- 
pio l'animazione risulta immagazzinata in "IoPSce- 
na" ed è richiamata dal blocco Load denominato 
"MostraScena" con un apposito link. 

• La demo è quasi pronta, non resta che definirne 
l'andamento temporale. Di solito conviene associa- 
re un operatore time ad una scena per fissare l'istan- 
te iniziale e la sua durata. Ogni demo deve necessa- 
riamente contenere un operatore di tipo demo chia- 
mato "mot", ossia radice, visualizzabile con il tasto r. 
A tale operatore vanno collegati, sempre con la soli- 
ta disposizione a cascata, un metronomo e la scena 
salvata in precedenza. Lo strumento permette di 
importare due formati musicali distinti: XM e OGG. 
Si tratta rispettivamente di moduli composti via 
tracker, con l'utilizzo di suoni campionati, e di file 
audio tipo MP3. Se volete demo di dimensioni ridot- 
te puntate sui moduli XM composti da voi oppure 
scaricati da Internet. 

• Finalmente possiamo compilare il nostro "capola- 
voro", generando così un eseguibile. Per fare ciò 
dobbiamo scegliere l'opzione Moke dal menu File. 
A questo punto ci verrà chiesto se creare una demo, 
una intro oppure un programma custom. Una intro 
rappresenta la versione limitata, per quanto riguar- 
da gli operatori impiegabili, della demo. Il vantaggio 
delle intro rispetto alle demo sta tutto nella dimen- 
sione dell'eseguibile, tendenzialmente inferiore ai 
64kbyte! L'opzione custom purtroppo non è disponi- 
bile pubblicamente. 

Un metodo alternativo per animare gli oggetti, e più 
in generale i parametri dotati dell'attributo A, consi- 
ste nell'inserire un operatore di tipo ChannelAnim 
(Fig. 6). 




Fig. 6: Animazione con l'operatore Channel Anim 

Tutti i parametri che condividono lo stesso valore di 
channel saranno animati in modalità single o dou- 
blé, è anche possibile specificare la modulazione: 
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Fig. 7: Tutti i parametri sono fondamentali! Animate 
deve essere impostato su ON 

rect, a rampa positiva o negativa, sinusoidale, trian- 
golare, etc. Cliccando sulla A appare un pannello 
(Fig. 7) per la configurazione dell'animazione in cui 
dovete porre Animate su ON, fate attenzione nella 
scelta dei valori perché sono tutti importanti! A que- 
sto punto selezionate l'operatore Channel Anim, 
premete s e successivamente il pulsante play. 
Se l'effetto non vi soddisfa probabilmente è il caso di 
aumentare la sua intensità tramite il parametro Arn- 
plify. Abbiamo usato solo una minima parte degli 
operatori presenti in Werkkzeug, considerando che i 
vari blocchi possono essere sovrapposti in tantissi- 
mi modi diversi e personalizzati con una miriade di 
parametri vi lascio immaginare la flessibilità dello 
strumento. I progetti salvati da Werkkzeug hanno 
estensione .lei, da non confondere con i file .klcl. Un 
file .kkl è risultato dell'esportazione della demo 
con il comando File /Export e può essere riprodotto 
con l'ausilio del player kkinol.exe. Vi faccio notare 
che l'eseguibile prodotto da File->Make non è altro 
che il player unito alle procedure e alle risorse pre- 
senti nel .kl. Al momento sono disponibili due file 
.kl, creati dal gruppo Farbrausch, da cui imparare i 
trucchi del mestiere: il tutorial ed il "sorgente" di FR- 
025-The.Popular.Demo. Il CD allegato alla rivista 
contiene il file .kl relativo alla demo proposta nel- 
l'articolo ed una piccola sorpresa! 



CONCLUSIONI 

Questo articolo è stato scritto a pochi giorni di 
distanza dal rilascio del programma, confido nell'in- 
teresse da parte degli sviluppatori e di conseguenza 
nell'aumento delle risorse ad esso dedicate. 
Spero di aver prodotto in voi, nonostante il limitato 
spazio a mia disposizione, uno stimolo ad appro- 
fondire l'argomento. Lo strumento proposto, unito 
alla "rinomata italica creatività", potrebbe contribui- 
re alla realizzazione di demo di successo. Al fine di 
promuovere l'utilizzo di Werkkzeug ho organizzato 
un piccolo contest, visitate il sito http://smeschini.al- 
tervista.org per avere maggiori informazioni sulla 
competizione! I membri del gruppo Farbrausch 
stanno lavorando alla terza versione di Werkkzeug, 
tenete sottocchio gli sviluppi del progetto. 
Alla prossima! 

Salvatore Meschini 
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Una midlet per inviare i nostri sms "quasi" gratuitamente 

SMS gratis! 

Scriviamo una applicazione per inviare SMS a meno di un centesimo 
di euro. Impareremo a far comunicare una midlet con una servlet 
e scopriremo come ridurre i byte scambiati via GPRS 



Questo mese vedremo come sia possibile far 
interagire una nostra midlet, installata su un 
terminale mobile GPRS (probabilmente un 
semplice telefonino!), con una servlet scritta "ad 
hoc". Ma il fine ultimo è molto meno nobile: al di là 
degli "scopi didattici", sfrutteremo questa interazio- 
ne per utilizzare un servizio offerto da Vodafone Ita- 
lia a tutti gli utenti iscritti al suo portale 190.it. Il ser- 
vizio in questione si chiama "SMS via mail", titolo 
abbastanza esplicativo che dovrebbe farvi intuire 
quale sarà l'utilizzo che faremo dell'applicazione fi- 
nita. 



IL SERVIZIO 
UTILIZZATO 

"Sms via e-mail" è un servizio offerto da Vodafone 
Italia a tutti i suoi clienti, se iscritti al portale 190.it, 
che permette di inviare fino a 10 SMS al giorno verso 
numeri Vodafone Italia in maniera completamente 
gratuita. L'utilizzo del servizio è abbastanza sempli- 
ce: inviando una mail all'indirizzo numero _destina- 
tario@sms.vodafone.it, verrà inviato un messaggio 
SMS al numero fornito, con il testo del subject e del 
body della mail. La mail deve essere inviata indican- 
do come mittente l'indirizzo e-mail fornito in fase di 
registrazione al sito 190.it, lo stesso su cui avete rice- 
vuto la conferma di registrazione e al quale Voda- 
fone invia la sua NewsLetter periodica. Dovrete ri- 
spettare una sola altra limitazione: la lunghezza del 
messaggio non deve essere superiore a 120 caratteri 
circa (il numero massimo di caratteri varia a secon- 
da dell'indirizzo mail del mittente, che ovviamente 
Vodafone include nel SMS per evitare messaggi ano- 
nimi). Come dicevo, il servizio è completamente 
gratuito, ad eccezione del costo sostenuto per l'invio 
della e-mail, che nel nostro caso è calcolato in base 
al traffico GPRS generato dall'applicazione. La tarif- 
fazione del collegamento GPRS non è, infatti, dipen- 
dente dal tempo di connessione, ma solo dal nume- 
ro di KB scambiati; utilizzando una sim Vodafone, 
spenderemo 0,06 euro per ogni KB scambiato. 
Ricordate che potete utilizzare l'applicazione attra- 



verso qualsiasi operatore (anche Tim e Wind), l'es- 
senziale è che siate registrati in 190.it. Fra le linee 
guida da rispettare vogliamo quindi tenere conto del 
traffico generato, in modo da minimizzare i costi 
sostenuti. Vedrete che, ad applicazione finita, riusci- 
remo a inviare un messaggio con un costo quasi 
nullo. Costo che si azzera del tutto per chi utilizza 
tariffe GPRS FLAT, cioè tariffe che sono indipenden- 
ti dal tempo di connessione e dalla quantità di byte 
scambiata. 



IL PROGETTO 

Le nostre scelte implementative dovranno dipende- 
re, oltre che dalla minimizzazione del traffico gene- 
rato, anche dalla ricerca della massima compatibi- 
lità con i vari terminali presenti sul mercato e con le 
configurazioni di accesso GPRS dei vari operatori 
mobili. In particolare, l'applicazione deve funziona- 
re sia con un profilo GPRS di tipo "web" sia con un 
profilo "wap". Questo perchè spesso i gestori offrono 
tariffe "a forfait" per l'accesso al wap via GPRS e noi 
non vogliamo scartare la possibilità di usufruirne 
con la nostra applicazione. Quindi, la connessione 
diretta ad un server SMTP via Socket andrebbe scar- 
tata, visto che in connessione wap non è ovviamen- 
te attuabile. La connessione diretta via SMTP va 
esclusa anche per la ricerca della compatibilità con i 
terminali, visto che la SocketConnection spesso non 
è supportata dai terminali MIDP LO, anche se se- 
condo le API dovrebbe esserlo. Infine, non scegliere- 
mo la connessione diretta per minimizzare il traffico 
generato. Infatti, una sessione SMTP per l'invio di 
mail richiede una serie di comandi e di autentica- 
zioni (standardizzati nel RFC 821) che la rendereb- 
bero ben più esosa, sia in invio che in ricezione, di 
una semplice richiesta ad una servlet, come vedia- 
mo nell'esempio: 



server> 


220 BBN-UNIX.ARPA Simple 


Mail Transfe 
Service 


r 
Ready 


client> 


HELO mail.tin.it 








server> 


250 fep02-svc.tin.it 










LI CD LI WEB 

SmsSemler.zip 



*** 



Hi 



190.it è il portale di 
Vodafone Italia che 
offre agli utenti iscritti, 
oltre all'utilissimo 
"sms via e-mail", la 
possibilità di inviare 
100 sms al giorno dal 
web, MMS gratuiti e, 
ovviamente, la 
gestione della propria 
sim Vodafone. 



jn 




REQUISITI 



h.i.!.wj.»j; 



— Basi di J2ME e di J2SE 

u 



J2SE 1.4.1 SDK o 
superiore, J2ME 
Wireless Toolkit 2.0 o 
superiore 
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+■ GLOSSARIO 



J2ME (Java 2 Mobile 

Edition) è la versione di 

Java 2 Standard Edition 

J2SE, ottimizzata per 

girare su cellulari e 

Palmari di ultima 

generazione. 

Una MIDIet è quindi 

una applicazione J2ME. 
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client> MAIL FROM: 

server> 250 Sender OK 

client> RCPTTO: 

server> 250 Recipient OK 

client> DATA 

server> 354 OK Send data ending with . 

client> From: xxx@javastaff.com 

dient> To: info@javastaff.com 

client> Subject: prova 

dient> prova di trasmissione. 

client> Sto provando il protocollo SMTP 

client> [Resto del messaggio] 

client> . 

server> 250 Message received 

client> QUIT 

server> 221 fep02-svc.tin.it ESMTP server closing connection 

Mentre una semplice richiesta HTTP GET è più 
"leggera": 

client>GET http://nomeserver/apps/smssender.php 

HTTP/ 1.0 

server>HTTP/l.l 200 OK 

server>Date: Wed, 17 Sep 2004 08:18:47 GMT 

server>Server: Apache/1. 3. 26 (Unix) PHP/4.2.3 

server>Expires: Thu, 19 Nov 1981 08:52:00 GMT 
server>Cache-Control: no-store, no-cache, post-check 

= 0, pre-check=0 
server>Connection: dose 
server>Content-Type: text/html 
server> [Contenuto della pagina HTML..] 

Dovremo ricordarci quindi di far restituire alla serv- 
let una risposta breve, per non sprecare inutili byte. 
Bisogna però analizzare se può una semplice (e 
quindi leggera) richiesta GET essere sufficiente per i 
nostri scopi o se dobbiamo scegliere una POST, che 
solitamente genera più traffico. La limitazione di 
una richiesta di tipo GET, infatti, è sulla lunghezza 
dell'URL, che secondo lo standard http (RFC 2616) è 
di massimo 256 caratteri. Possono bastarci? Faccia- 
mo un rapido calcolo: per il messaggio ci servono 

massimo 120 caratte- 
ri, la lunghezza di un 
indirizzo mail è me- 
diamente inferiore a 
25/30 caratteri (es: 
luca. mattei@javastaff 
.corri], un numero di 
cellulare è lungo 10 
caratteri. Ne riman- 
gono quasi 100 per 
indicare il path della 
servlet e per i nomi 
dei parametri: sono 
più che sufficienti! 
Quindi, quella che 
sembrava una limita- 
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zione (i 256 caratteri massimi della URL) si rivela un 
utile aiuto anche nell'ottica della ricerca della mini- 
mizzazione dei byte scambiati: in uscita avremo 
massimo 300 caratteri (e quindi byte). Confermiamo 
come valida la scelta di utilizzare una servlet come 
tramite per trasmettere la mail al server SMTP che si 
prenderà carico di consegnarla al server della Vo- 
dafone. Possiamo quindi pensare ad una infrastrut- 
tura del tipo rappresentata in Fig. 1. 



LA SERVLET 

Iniziamo analizzando la parte server del progetto, 
che è una semplice Servlet con cui la nostra midlet 
dovrà dialogare. In sostanza, la servlet deve essere in 
grado di ricevere alcuni parametri attraverso la ri- 
chiesta GET e, dopo averli elaborati, connettersi ver- 
so un server SMTP e inviare la mail all'indirizzo "nu- 
mero_destinatario@sms.vodafone.it". La servlet quin- 
di sarà piuttosto semplice, dovendo implementare 
solo il metodo doGet (possiamo evitare il doPost, 
dato che abbiamo deciso di non utilizzare la Post 
Http). I parametri della GetHttp sono disponibili at- 
traverso il metodo: request.getParameter("nome_pa- 
rametro ") dove request è una HttpServletRequest, che 
ci viene passata nel metodo doGet. I parametri di cui 
abbiamo bisogno sono il numero del destinatario, 
messaggio vero e proprio e la mail del mittente: 




Fig. 1: Una rappresentazione della infrastruttura con le inte- 
razioni fra i diversi "agenti" protagonisti della transazione di 
un messaggio 



Attraverso la HttpServletResponse, possiamo comu- 
nicare al client l'esito dell'operazione. Basta utilizza- 
re il PrintWriter ottenuto attraverso il metodo get- 
WriterQ. Vediamo in dettaglio il codice che gestisce 
dialogo con il client: 

public void doGet (HttpServletRequest request, 

HttpServletResponse response) throws 
ServIetException, IOException { 
PrintWriter out; 

Strìng to = request. getParameter("to"); 
Strìng from = request. getParameter("from"); 
Strìng text = request. getParameter("text"); 
response. setContentType("text/html"); 
out = response. getWriter(); 
try{ 

Send Mail(to+"@sms. vodafone.it", from, text); 

out. println(" Messaggio Inviato\n");} 
catch(Exception e) { 

out.println("Errore in invio:\n"+e.toString());} 
out.close(); } 

Resta da vedere come implementare il metodo: 
SendMail(String destinatario,String mittente, Strìng 
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testo). Potremmo utilizzare il package JavaMaìl, ma 
preferiamo vedere in dettaglio come sia possibile in- 
viare una mail utilizzando una Socket per dialogare 
con un server SMTE Secondo l'RFC 821, che è lo 
standard per la comunicazione via SMTP, client 
deve inviare in sequenza una serie di comandi ai 
quali, volta per volta il server risponde con un diver- 
so messaggio di successo. Ad esempio al comando: 

HELO nomeserver.com 

il server risponde, in caso di successo, con: 

250 fep02-svc.tin.it 

In cui 250 è il codice di successo. Analizziamo ora il 
metodo che ci permette di inviare la mail: 

SendMail(String to, String from, String message) 

throws ProtocolException, IOException{ 
Socket socket = new Socket(MAIL_SERVER_URL, 

MAIL_PORT); 

in = new DataInputStream(socket.getInputStream()); 
out = new PrintStream(socket.getOutputStream()); 
if(!checkStatus("220")) throw new ProtocolException(str); 

out.println( "HELO " + MAIL_SERVERJJRL ); 

out.flush() ; 
if(!checkStatus("250")) throw new ProtocolException(str); 

OUt.println( "MAIL FROM: " + from ); 

out.flush() ; 
if(!checkStatus("250")) throw new ProtocolException(str); 

out.println( "RCPTTO: " + to ); 

out.flushQ ; 

if(!checkStatus("250")) throw new ProtocolException(str); 

out.println( "DATA" ); 

out.flushQ ; 

if(!checkStatus("354")) throw new ProtocolException(str); 
/* Il codice di successo questa volta non è 250, 

ma 354; * 

* da adesso il client trasmette la mail vera e 

propria, conclusa da * 

* un punto su una linea vuota. */ 
out.println("From: " + from); 
out.println("To: " + to); 

out.println( "Subject: \n" ); //il Subject non è 

necessario, lo lasciamo vuoto 

out.flushQ ; 

out.println("X-Mailer: SmsSender Servlet 1.0"); 
out.println(""); 
out.println( message ) ; 
out.println(".") ; 

out.flushQ ; 

if(!checkStatus("250")) throw new ProtocolException(str); 

out.println("QUIT"); 

out.flushQ; 

in.closeQ; 
socket. closeQ; 



Avrete notato che abbiamo utilizzato il metodo 
checkStatus (String codice) per verificare che il server 
avesse "capito" la nostra richiesta. Questo metodo 
non fa altro che ricevere dalla DatalnputStream la ri- 
sposta e verificare se i primi caratteri corrispondono 
al codice che ci attendiamo di ricevere. Se qualcosa 
è andato storto, lanceremo una eccezione: 

private boolean checkStatus(String RFC)throws 

Protocol Exception,IOException{ 
str = in.readLineQ; 
System. out. println(str); 
if (Istr.startsWith(RFC)) throw new ProtocolException(str); 

while (str.indexOf('-') == 3) { 

str = in.readLineQ; 
if (!str.startsWith("RFC")) throw new 

ProtocolException (str); 

_J 

return true; 

} 

Potete installare la vostra servlet, magari con qual- 
che modifica, su MyJavaServer.com, un server che 
offre hosting java gratuitamente. Il processo di com- 
pilazione e installazione è abbastanza semplice, 
dato che avviene dal pannello di controllo del sito 
con una semplice form. Basta procedere all'upload 
del file .java via ftp, quindi, una volta identificati in 
"member area", cliccare su "java compiler" e indica- 
re il nome del file. Se per caso non avete voglia di 
creare un vostro account, non disperate, potete uti- 
lizzare quella appositamente utilizzata per scrivere 
questo articolo, che è reperibile all'URL: www.myja- 
vaserver.com/servlet/pdfcrawler.SmsSenderServlet. 
Ora manca solo un client in grado di utilizzarla. 



QUANTO SI RISPARMIA? 





GLOSSARIO 



J2EE (Java 2 Enterprise 
Edition), è la parte di 
java che la Sun ha 
dedicato alle 
applicazioni server. 
Una servlet è una 
applicazione java fatta 
per girare su un 
application server e 
può essere interrogata 
via http. 



Il costo del singolo messaggio inviato con SMSSender dipende sia dalla 
tariffa che dal protocollo utilizzato per il collegamento. Per coloro i quali 
utilizzano il protocollo GPRS, la dimensione del singolo messaggio 
(comprensiva di tutti i dati scambiati con il server) sarà di circa 1KB, 
mentre per chi utilizza un collegamento Wap, la dimensione media si 
aggirerà sui 2,5KB. Ovviamente, per chi gode di una tariffa fiat, il costo del 
singolo messaggio si azzera. 





Via GPRS Via WAP 


TIM 


0,6 


4 








0,6 


3 


Wind 


0,3 


4 


H3G-3 


da 0,2 a 0,6 a seconda 
dei piani tariffari 


non 
disponibile 



I valori sono espressi in centesimi di euro per KByte. 

Per calcolare il costo del messaggio, basta moltiplicare la dimensione in 
byte per il coefficiente indicato in tabella. Ad esempio, un SMS inviato con 
scheda Vodafone via GPRS costerà (circa) 1[KB] * 0,6 [eurocent/KB] = 0,6 
centesimi di Euro. Il che vuol dire che, al costo di un Euro, potremo 
mandare oltre 160 messaggi! 
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URL ENCODING 

Una premessa è necessaria, prima di intraprendere 
la scrittura della midlet client. Lo standard HTTP 
prevede che in una richiesta Get, i parametri venga- 
no accodati all'indirizzo, dopo un "?" divisi dal carat- 
tere "& ". Ad esempio, se la variabile da passare è text, 
il cui valore è "prova", avremo: httpjlserverlservlets 
/SendMail?text=prova&destinatario=3401234567. I 
valori delle variabili vanno però codificati seguendo 
alcune regole. Bisogna infatti sostituire alcuni carat- 
teri non ammessi con il loro equivalente UNICODE. 
Questi caratteri sono solitamente caratteri riservati, 
per esempio il simbolo di "dollaro" ("$") quello di "e 
commerciale" ("&"), lo spazio e così via. Nella Tab. 1 
trovate alcune codifiche UNICODE corrispondenti 
ai più comuni caratteri "riservati" che possono esse- 
re utilizzati in un 
SMS in lingua ita- 
liana. Dovremo 
quindi scrivere un 
metodo che, data in 
ingresso una strin- 
ga contenente 
Fig. 2: Il forni per la compilazione delle servlet su MyJavaServer J'tjrt ner la GET ne 

restituisca un'altra con i caratteri codificati. Purtrop- 
po un metodo del genere in MIDP 1.0 non esiste. Ma 
non ci perdiamo d'animo: ne scriviamo uno ad hoc! 



public String urlEncode(String url){ 
url = replace(url,'à','' /bEO"); 
url = replace(url,'è',"%E8"); 

return uri;} 
public String replace(String origine, char orig, String dest){ 
String appoggio=origine; 
for (int i=0;i<appoggio.length();i++) 
if (appoggio. charAt(i)! = orig) 

origine+=appoggio.charAt(i); 
else origine+=dest; 
return origine; } 



LA RICHIESTA GET 

Incominciamo la scrittura della midlet partendo 
dalla parte più importante: l'invio del messaggio 
attraverso una richiesta "Http Get". Facciamo conto 
di aver già ottenuto dall'interfaccia grafica il mes- 
saggio e il numero del destinatario. La mail del mit- 
tente possiamo definirla direttamente nel codice, 
scelta veloce, ma valida solo se si vuole essere gli 
unici utilizzatori della midlet, con la riscrittura della 
stessa ogni volta che un amico o collega ce la chie- 
derà... e fidatevi che vi accadrà facilmente. Inoltre 
potrete utilizzare un solo account, mentre, se avete 
più di una sim Vodafone, potreste inviare più di 10 
SMS al giorno, con una gestione della mail mittente 




MyJavaServer.com è un 

application server 

gratuito e molto 

funzionale, che ci dà la 

possibilità di mettere 

online le nostre 

applicazioni java 

server. Supporta: 

J2SE 1.5, Servlet 2.3, 

Java Server Pages 

(JSP) 1.2 
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più accurata. Quindi, un'idea potrebbe essere quella 
di una form per l'immissione dell'indirizzo, con 
conseguente salvataggio su RMS. Ma partiamo dalla 
base, la richiesta GET: il package javax.microedi- 
tion.io ci mette a disposizione la classe HttpConnec- 
tion dalla quale possiamo ottenere l'InputStream su 
cui leggere la risposta. La richiesta vera e propria la 
farà java, una volta aperto il Connector attraverso 
metodo open(String uri). Ma vediamo direttamente 
il codice: 

URL=URLServlet + "?text=" + mess +"&to=" + 

n+"&from="+MailMittente; 

URL=urlEncode(URL); 

String response = ""; 

HttpConnection e = nuli; 

tryj 

// apriamo la connessione http all'indirizzo specficato sopra 

e = (HttpConnection)Connector.open(URL); 

// una volta che la connessione è stabilita 

// apre un input stream 

InputStream is = c.openlnputStreamQ; 

int eh; 

// legge byte per byte l'inputStream e 'appende' 

// i singoli caratteri nel buffer response 

while ((eh = is.readQ) != -1) { 

response=response+( (char)ch );} 

// chiudiamo l'InputStream. 

is.close(); 

// chiudiamo la connessione 

c.close(); } 
catch ( IOException e ) { 

//notifica l'eccezione } 

Se la servlet ha funzionato a dovere la stringa buffer 
conterrà il risultato "Messaggio Inviato", che potre- 
mo notificare direttamente all'utente. Da notare la 
composizione dell'URL, che incorpora, come da 
specifiche dell'HTTP il messaggio, il mittente e il 
destinatario, divisi dal carattere "&": 



URL=URLServlet + "?text= 



+ mess +"&to=" + 
n+"&from="+MailMittente; 



Per quanto riguarda la segnalazione del mancato 
invio del messaggio, può avvenire per un errore sulla 
servlet o nella comunicazione fra la midlet e la serv- 
let. I possibili errori della servlet sono automatica- 
mente mostrati nella risposta che troviamo in re- 
sponse. Infatti, come ricorderete, nel catch della ser- 
vlet avevamo fatto in modo che fosse riportata chie- 
sto la motivazione dell'eccezione lanciata: 

out.println("Errore in invio:\n"+e.toString()); 

La stessa cosa possiamo farla in caso di errori nel 
tentativo di fare la richiesta GET. Quindi, nel catch 
del metodo Send della midlet, potremo accodare a 
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response il motivo dell'eccezione lanciata, in modo 
che nell'interfaccia grafica non dovremo fare altro 
che scrivere la stringa "Messaggio Inviato" nella 
Form finale, che corrisponderà al successo dell'ope- 
razione. Il nucleo dell'applicazione è questo, niente 
di difficile, e con il vantaggio di mantenere i dati 
inviati e ricevuti sotto una soglia considerevole e 
soprattutto di poter essere effettuata praticamente 
da tutti i cellulari, anche da quelli più "anziani". Il 
resto altro non è che un'interfaccia grafica per l'in- 
serimento del messaggio e del numero del destina- 
tario ed eventualmente per la gestione mittente uti- 
lizzato. 



L'INTERFACCIA 
UTENTE 

Anche nella scrittura dell'interfaccia grafica dovre- 
mo mirare ad un obiettivo: l'applicazione dovrà es- 
sere il più veloce possibile, evidentemente perché 
speriamo che venga utilizzata molto di frequente. 
È ovvio che, se risultasse macchinosa o lenta, tende- 
remmo a preferire l'uso del composer standard del 
telefono, anche se più costoso. In questo purtroppo 
siamo ostacolati da un problema insormontabile: 
l'impossibilità di accedere alla rubrica. Per la verità, 
su alcuni Siemens mittente può essere preso da 
rubrica. Il produttore ha pensato bene di poter far 
scegliere, nel caso di un TextField costruito con 
TextField.PHONENUMBER come parametro, il nu- 
mero dalla rubrica interna. Va sottolineato che l'im- 
possibilità di accedere alla rubrica attraverso J2ME 
discende da una ben precisa scelta dei progettisti in 
base a criteri di sicurezza. Una midlet, come una ap- 
plet, viene eseguita in una "SandBox " che la isola dal 
resto del sistema operativo del terminale, evitando 
l'accesso a dati che potrebbero essere privati. D'altra 
parte, però, si limitano fortemente gli sviluppatori 
nel loro lavoro rendendo solitamente le applicazioni 
J2ME povere di funzionalità, soprattutto se confron- 
tate ad applicativi per smartphone, scritti nel lin- 
guaggio nativo del sistema operativo (per esempio 
Symbian), che possono accedere a tutte le funziona- 
lità del cellulare, senza limitazioni. Capirete quindi 
che, benché l'applicazione sia progettata per poter 
girare su quanti più terminali possibili, su alcuni, 
grazie all'impegno della casa madre, avremo delle 
funzionalità aggiunte che non ci aspettavamo ma 
che ci fanno indubbiamente piacere. Comunque, 
per non rendere macchinoso l'utilizzo della midlet, 
eviteremo inutili schermate di riepilogo o di confer- 
ma, cosa che renderà forse spartana la nostra appli- 
cazione, ma ne salvaguarderemo la funzionalità e la 
rapidità. Ciononostante, potremo permetterci una 
piccola immagine, come il logo del programma, nel- 
la schermata principale, a patto che l'operazione di 
caricamento e visualizzazione della png siano rac- 



chiuse in costrutti di tipo try e catch che non impe- 
discano l'esecuzione su terminali che non le sup- 
portano (ad esempio perché dotati di display mono- 
cromatico). L'applicazione potrà, quindi, essere 
strutturata in tre diverse Form, una iniziale, con due 
TextField (numero destinatario e messaggio), una di 
presentazione del risultato di invio e una per l'im- 
missione e la modifica della mail mittente (Fig. 3). 
Analizziamo la prima Schermata. Innanzitutto avre- 
mo istanziato la Form, che rappresenta lo "Screen" 
su cui andare ad "appendere" i vari oggetti grafici 
("Field") da utilizzare. Avremo quindi una Form 
aForm su cui "appendere" i vari TextField e i Com- 
mand che ci permettono di passare agli stadi suc- 
cessivi della applicazione. Fondamentale è con- 
trollo su MailMittente, ottenuta attraverso il metodo 
readRecordsO che va ad accedere via RMS alla mail 
salvata e se non è presente, fa partire automatica- 
mente la form per l'immissione e salvataggio: 

public void Setup() { 

inviando = new Form("Inserire mail"); 
salvataggio = new Command("Invia", Command.OK, 1); 
exit = new Command("Esci", Command.EXIT, 2); 
String istruzioni="Inserire indirizzo indicato in fase di 
registrazione sul sito www.190.it"; 
mail=newTextField("Mail:", "", 120, TextField. EMAILADDR); 
inviando. append( istruzioni); 
inviando.append(mail); 
inviando.addCommand(salvataggio); 
inviando.addCommand(exit); 
inviando. setCommandListener(this); 
d.setCurrent(inviando); } 

Il Command salvataggio awierà una funzione per 
salvare la mail su RecordStore (RMS). Per salvare e ca- 
ricare una stringa, scriviamo due funzioni, che uti- 
lizzano i metodi addRecord(rec, 0, ree. length) e getRe- 
cord(i, recData, 0) che ci fornisce il dato precedente- 
mente salvato in recData, un array di byte. Passare 
da un array di byte a una stringa è facile, attraverso il 
costruttore new String(byte[]). L'operazione inversa 
avviene attraverso il metodo StringgetBytesO, che 
restituisce proprio un byte[]. La terza e ultima Form 
dovrà solo presentare i risultati e permettere il ritor- 
no alla schermata principale, quindi basterà integra- 
re nella funzione per l'invio dei dati via Http Get, 
tutti i Command e l'append della stringa result: 

inviando = new Form("Invio in corso"); 

torna = new Command("Ritorna", Command.OK, 1); 

exit = new Command("Esci", Command.EXIT, 2); 

inviando.addCommand(exit); 

inviando.setCommandListener(this); 

inviando. append("Connessione in corso.."); 

d.setCurrent(inviando); 

//istruzioni per l'invio del messaggio come visto prima 

inviando, append (response); 
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Fig. 3: Le tre Form 

utilizzate dalla nostra 

applicazione. 

Nella seconda screen- 

shot la conferma che il 

messaggio è stato 

inviato 
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invia ndo.addCommand(torna); 

Probabilmente vi starete chiedendo chi gestisce il 
passaggio da una Form ad un'altra. La nostra mid- 
let, per poter utilizzare i Command, deve implemen- 
tare una interfaccia (CommandListener) ed in par- 
ticolare un metodo: commandAction(Command e, 
Displayable s). Qui basterà riconoscere quale è l'a- 
zione richiesta e richiamare il metodo voluto. 
Per esempio: 



if (e 



invia){send(); } 




Fig. 4: Diamo il nome alla nostra nuova "creatura" 



Tutto ciò risulta valido se 
invia è un Command de- 
finito in maniera globale 
nella nostra midlet, come 
abbiamo fatto nel nostro 
progetto. Se invece prefe- 
riamo definire i Com- 
mand di volta in volta in 
ogni metodo, ricono- 
scimento possiamo farlo 
sulla label assegnata: 




Fig. 5: Ecco i primi passi 
della nostra MIDIet sul- 
l'emulatore 



//se invia è così definito: 

//invia = new Command("Invia", Command. OK, 1); 

//possiamo usare: 

if (c.getl_abel().equals("Invia")){ 

send(); 
} 



CREARE 
L'APPLICAZIONE 

Abbiamo visto come disegnare le tre Form e come 
gestire il passaggio da una all'altra, ora vediamo 
come mettere insieme tutti i pezzi ed in particolare 
come creare l'archivio da installare sul cellulare. Una 
midlet, per poter essere riconosciuta tale, deve 
estendere la classe javax.microedition.midlet.MIDlet 
e implementare i tre metodi startApp, pauseApp e 
destroyApp. I tre metodi vengono richiamati dal cel- 
lulare rispettivamente quando l'applicazione viene 
avviata, messa in pausa (per l'arrivo di una chiama- 
ta per esempio) e chiusa. Nel nostro caso startApp 
awierà il metodo che visualizza la prima Form, 
pauseApp invece, essendo la nostra applicazione del 
tutto sequenziale ed interattiva, non dovrà fare nul- 
la. Lo stesso discorso vale per destroyApp dato che 
non abbiamo dati da salvare o altre operazioni da 
eseguire in chiusura della applicazione. Supponia- 
mo quindi di avere finito di scrivere il sorgente .java. 
Siamo sicuramente ansiosi di poterlo vedere in fun- 
zione perlomeno su di un emulatore! Avviamo il 
programma kToolbar del J2ME Wireless Toolkit, sce- 
gliamo di creare un nuovo progetto e chiamiamolo 



SmsSender. Indichiamo il nome della classe che 
estende MIDIet, nel nostro caso sempre SmsSender. 
Il toolkit ci chiederà di configurare il progetto, modi- 
ficando qualche impostazione: innanzitutto la "Tar- 
get Platform ", portandola a "MIDP 1.0", poi, sotto la 
tab "Optional "i vari campi, in particolare la "MIDlet- 
Icon" che sarà l'icona che distinguerà la nostra ap- 
plicazione dalle altre. Bisogna poi copiare, come ci 
viene indicato, i sorgenti nella cartella apps\SmsSen- 
der\src\ che è stata appena creata nella directory 
dove abbiamo installato il toolkit (solitamente 
c:\WTK22X). Dovremo allo stesso modo mettere i file 
"risorsa" nella cartella res, nel nostro caso due im- 
magini png: logoBig.png che utilizziamo nella midlet 
e logo.pngche usiamo come icona dell'applicazione 
e le eventuali librerie (noi non ne abbiamo) nella 
cartella lib. Ora possiamo eseguire la compilazione 
del progetto cliccando su "Build". Se tutto è andato a 
buon fine, basterà scegliere "Run" per vedere la no- 
stra creatura fare i primi passi sull'emulatore. Una 
volta sicuri che la nostra applicazione non dia pro- 
blemi al terminale, saremo sicuramente ansiosi di 
verderla in azione direttamente sul nostro cellulare. 
L'operazione di installazione è abbastanza sempli- 
ce, per prima cosa bisogna far generare l'archivio 
(filey'ar) e il descrittore (fUejad), cliccando su "Pac- 
kage"^ "Create Package" nel menù Project. Control- 
late nella cartella bin del progetto, troverete SmsSen- 
der.jad e SmsSender.jar, i due file necessari per l'in- 
stallazione dell'applicazione. Ora dovete inviare al 
cellulare la midlet, operazione diversa da modello a 
modello. Potete inviarla via infrarossi, bluetooth, ca- 
vetto o scaricarla via wap dopo averne fatto l'upload 
su un server. A voi la scelta. 



CONCLUSIONI 

I più attenti avranno notato contatore di caratteri 
in basso nella schermata iniziale, molto utile per sa- 
pere quanti caratteri avete ancora a disposizione. 
Questa è solo una delle possibili funzioni aggiuntive 
che potete inventarvi. Altre potrebbero essere un ar- 
chivio per i messaggi salvati, una rubrica interna, 
uno "spezzettatore" che divida i messaggi più lunghi 
di 120 caratteri e chissà quanti altri. Comunque il 
conta-caratteri (che trovate nella versione presente 
sul CD allegato alla rivista) è di rapida implementa- 
zione. Si tratta di una Strìngltem che viene aggiorna- 
ta, ogni volta che il TextField del messaggio viene 
modificato, da un ItemStateListener che ne verifica la 
sizeO- Ricordatevi di impostare correttamente il vo- 
stro telefono con la configurazione gprs di tipo web, 
prima di utilizzare l'applicazione. Per farlo basta cer- 
care nel sito del produttore del vostro cellulare o del 
vostro operatore di telefonia. 
Buon lavoro! 

Luca Mattei 
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Miglioriamo la longevità e la flessibilità delle nostre applicazioni 

Un 'applicazione 
aperta ai plug-in 

Un buon software deve prevedere la possibilità di estendere 

le proprie funzionalità tramite componenti esterni: scopriamo come 

includere questa opportunità nelle applicazioni Visual Basic 



Le applicazioni moderne tendono sempre più a 
offrire l'apertura verso plug-in realizzati da 
terze parti. Il perché di questa scelta è piutto- 
sto evidente, scrivere software orientato ai plug-in 
offre numerosi vantaggi, fra i quali: 

• Un più semplice lavoro di squadra. Mentre un 
team di programmatori lavora per rendere sta- 
bile l'applicazione di base, altre squadre pos- 
sono curare lo sviluppo dei plug-in. 

• Maggiore longevità. La possibilità di integrare 
componenti esterni è fondamentale in pro- 
grammi che fanno uso di strumenti soggetti a 
rapido aggiornamento. 

• Migliore integrazione. È possibile far condivi- 
dere gli stessi plug-in ad applicazioni diverse, 
dando così l'impressione di una notevole coe- 
renza interna ad una suite di prodotti intima- 
mente differenti. 

• Specializzazione e personalizzazione. Per- 
mettere a software house esterne di sviluppare 
aggiunte per il proprio software è la mossa mi- 
gliore per consentire la distribuzione del pro- 
prio programma in paesi stranieri, per favorire 
l'integrazione di strumenti per accesso facilita- 
to (come barre braille per i non-vedenti) o, più 
in generale, per garantire funzionalità speciali- 
stiche ad una determinata categoria d'utenti. 

Anche una semplice applicazione gestionale può 
aumentare di molto la propria efficienza e versatilità 
avvalendosi di questo principio. Ma qual è la tecnica 
per implementare una funzionalità simile in Visual 
Basic? I passi da compiere possono essere sintetiz- 
zati come segue: 

1. Individuare le necessità dell'applicazione di ba- 
se in relazione ai componenti: ovvero stabilire 
che cosa è richiesto e cosa deve essere necessa- 



riamente fornito ai plug-in. 
Scrivere un'interfaccia contenente metodi e pro- 
prietà prescelti, e salvarla in una libreria di classi 
ActiveX. 

Scrivere il codice necessario per il caricamento e 
la gestione dei plug-in all'interno dell'applica- 
zione di base. 

Implementare ogni plug-in come una DLL Acti- 
veX appartenente ad una classe (la stessa per 
tutti) che eredita dall'interfaccia prestabilita. 



IL PROGETTO 
"PLUG 'HI PAINT" 

Come esempio pratico della tecnica sopra esposta, 
verrà creato un progetto molto semplice: il "plug 'n 
paint". Realizzeremo un'applicazione di disegno 
molto simile allo storico Paintbrush di Windows, ma 
con in più la possibilità di estendere, mediante plug- 
in, gli strumenti a disposizione. Il software sarà dun- 
que diviso in due: da una parte l'applicazione di ba- 
se, che si preoccuperà di caricare dinamicamente i 
plug-in, verificarne il corretto funzionamento, e fun- 
gere da "direttore d'orchestra". Dall'altra i plug-in 
stessi (pennello, gomma, spray, etc. . .), che verranno 
richiamati opportunamente dall'applicazione di ba- 
se, e disegneranno sulla tela. Per sviluppare l'appli- 
cazione, seguiremo fedelmente i quattro passi espo- 
sti nel paragrafo precedente. La nostra applicazione 
di base esporrà solo le funzionalità strettamente 
necessarie alla corretta gestione dei plug-in: lo svi- 
luppo di soluzioni tipiche di questo genere di appli- 
cazioni (uso di buffer multipli, selezione di regioni, 
wrapper GDI, undo-redo, e via elencando) appesan- 
tirebbe solo gli esempi ed esulerebbe dallo scopo 
della trattazione. Tutto ciò di cui abbiamo bisogno è 
una ToolBar (TBarTool) per la selezione degli stru- 
menti, un ImageList (ImListTool) per il caricamento 
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Sul CD sono presenti 
due versioni del pro- 
getto di esempio. La 
prima è relativa all'im- 
plementazione iniziale 
di ITool. La seconda (in 
PnP2), inerente 
l'espansione del meto- 
do di comunicazione, 
presenta anche la rea- 
lizzazione di alcuni 
strumenti aggiuntivi, 
come lo spirografo. 
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Fig. 1: L'applicazione d'esempio Plug 'n Paint, si 
basa interamente su plug-in per disegnare forme 
diverse, come questo fiocco di neve 



delle rispettive immagini, un FileListBox (FileTool) 
per rintracciarne velocemente i file sul disco, e un 
PictureBox (PBoxTela) che costituirà la nostra area di 
disegno. In Fig. 2, è possibile ammirare il nostro 
spartano form di partenza. 



NECESSITA 
DELL'APPLICAZIONE 

Ora che sappiamo com'è fatta la nostra applicazione 
di base, si tratta di passare al primo punto della lista: 
individuare i compiti dei plug-in. 
Questi dovranno fornire al programma principale: 
un nome che li identifichi (dal momento che tutti 
appartengono alla stessa classe); un'icona da asso- 
ciare al relativo pulsante 
sulla toolbar e un "pro- 
perty form" relativo alle 
opzioni dello strumento, 
simile a quello che si ot- 
tiene premendo il tasto F4 
di Visual Basic. L'applica- 
zione di base, invece, do- 
vrà preoccuparsi di notifi- 
care al plug-in corrente- 
mente selezionato i prin- 
cipali eventi che interes- 
sano la tela: il MouseMove, 
il MouseDown e il Mouse- 
Up sono sufficienti. 




Fig. 2: 1 componenti 
essenziali per la prima 
realizzazione del form 



CREAZIONE 
DELL'INTERFACCIA 

Tutto quello che abbiamo stabilito nel paragrafo 
precedente è il minimo indispensabile perché un 
plug-in riesca a svolgere decentemente il proprio la- 
voro. Una volta stabilita la struttura, questi eventi 
devono necessariamente essere definiti da ciascun 
metodo, dal momento che la mancanza di uno sol- 
tanto di questi elementi potrebbe mandare in crash 
l'applicazione: cosa succederebbe, ad esempio, se 
venisse chiamato un metodo Tool.MousemoveO, 
quando il plug-in non lo espone? Dobbiamo, quindi, 
fornire il prototipo delle funzioni e delle proprietà 
che uno strumento dovrà necessariamente imple- 
mentare. Questo sembra un modello ragionevole: 

Public PBoxTela As PictureBox 

Public Nome As String 

Public PropertyForm As Form 

Sub MouseDown(Button As Integer, Shift As Integer, X 

As Single, Y As Single) 

End Sub 

Sub MouseUp(Button As Integer, Shift As Integer, X 

As Single, Y As Single) 




Quella che abbiamo appena scritto prende il nome 
di 'interfaccia'. Un'interfaccia è, uno scheletro che si 
limita a stabilire i metodi e le proprietà che una clas- 
se derivata deve necessariamente esporre, ma lascia 
a quest'ultima l'onere della loro implementazione. 
Abbiamo, insomma, stabilito un 'contratto' fra la no- 
stra applicazione e il plug-in, che quest'ultimo è te- 
nuto a rispettare. Per completare il secondo punto, 
però, dobbiamo ancora salvarla in una libreria di 
classi. 



CREAZIONE 
DELLA LIBRERIA 

Dal momento che l'interfaccia stabilita nel para- 
grafo precedente dovrà essere utilizzata nella nostra 
applicazione e in tutti i plug-in, è fondamentale sal- 
varla in una libreria di classi (DLL ActiveX), che ne fa- 
vorisca il riutilizzo. Bisognerà dare a quest'interfac- 
cia un nome appropriato: ITool è una buona idea (la 
prassi comune è che il nome delle interfacce inizi 
con la lettera 1). Apriamo, quindi, una nuova istan- 
za di Visual Basic, scegliamo il progetto ActiveX DLL, 
modifichiamo il nome della classe "Classi", in 
"ITool", e all'interno di questo modulo scriviamo la 
struttura riportata nel paragrafo precedente. Dob- 
biamo dare un nome facilmente riconoscibile a que- 
sta libreria, quindi andiamo in Project/Properties, e 
nel campo "descrizione" scriviamo "Plug 'n Paint Ty- 
pe Library". Una volta compilata (File IMake), questa 
libreria si rivelerà una struttura portante: dovremo 
ricordarci di includerla nell'SDK che forniremo agli 
sviluppatori esterni! (Files su CD: PPInterfaces.Vbp, 
ITool.Cls, PPInterfaces.DLL, da registrare mediante 
RegSvr32 .exe). 



CARICARE I PLUG-IN 

Al terzo punto della scaletta proposta all'inizio, tro- 
viamo l'implementazione di una routine fonda- 
mentale, appartenente all'applicazione di base: 
quella relativa al caricamento degli strumenti. 
Prima di scriverla dobbiamo assicurarci di include- 
re nel progetto il riferimento alla libreria che abbia- 
mo costruito nel paragrafo precedente, andando su 
Project/ References e spuntando la libreria in que- 
stione. Ora possiamo scrivere la routine che, per 
semplicità, qui è associata direttamente all'evento 
Form Load. 
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Private Sub Form_Load() 

FiléTbols. Patri = App.Path & "\Strumenti" 

'Carichiamo i componenti 

Dim i As Integer 

For i = To FileTools.ListCount - 1 

'Registriamo il componente in modo invisibile 

Shell "regsvr32 -s """ & FileTools.Path & "\" & 
FileTools.List(i) & '" 

'Prendiamo il nome del componente (senza l'estensione) 

Dim NomeFile As String 

NomeFile = Left(FileTools.List(i), Len(FileTools.List(i)) - 4) 

'Carichiamo l'oggetto in una variabile d'appoggio 

Dim tempTool As ITool 

Set tempTool = CreateObject(NomeFile & ".CTool") 

'Aggiungiamo l'oggetto alla collection 

Tools.Add tempTool 

Set Tools(i + l).PBoxTela = PBoxTela 

[...] segue codice relativo al caricamento delle immagini 

Next 

End Sub 

Qui sopra è riportato un lungo estratto (è stata elimi- 
nata la gestione delle icone sulla toolbar) della routi- 
ne di caricamento, il cui codice integrale è presente 
nel file allegato su CD. Vale la pena di leggere con 
attenzione questo codice, visto che è cuore del si- 
stema. Ogni plug-in andrà salvato nella sottocartella 
"strumenti", ed è a quella che punta FileTools. Me- 
diante un ciclo, ogni DLL viene registrata con reg- 
svr32: un prassi comune che garantisce il funziona- 
mento di un componente anche se questo non è 
stato configurato tramite installer. È anche consi- 
gliato deregistrare i componenti con un altro ciclo 
associato all'evento Form_QueryUnloade, mediante 
una chiamata a RegSvr32 -u, in modo da non appe- 
santire inutilmente il sempre stracarico registro di 
configurazione di Windows. Il componente viene 
quindi caricato con TempTool = CreateObject(nome 
.CTool), il che impone: 

1 . Che il plug-in sia un ActiveX DLL. 

2. Che la classe di ogni plug-in dovrà chiamarsi 
CTool. 

3. Che il nome del file ogni plug-in dovrà coincide- 
re col di progetto dello stesso. 

4. Che la classe CTool implementi l'interfaccia 
ITool. 

Dovremo tener conto di tutti questi vincoli quando 
scriveremo i componenti, e farli presenti agli svilup- 
patori esterni. È interessante notare che si è usata 
una variabile temporanea di tipo ITool (TempTool) 
per il valore di ritorno di CreateObject, cosa che 
impone all'istruzione un Queiy Interface per stabili- 
re se la conversione sia possibile (da cui la necessità 
del vincolo 4). Nel momento in cui questa avviene 
con successo, disponiamo di un oggetto in cui è pos- 
sibile usare i metodi della proprietà ITool, ma con 



l'implementazione particolare stabilita in CTool. 
Potenza del polimorfismo! Dopo questa routine, il 
lavoro è tutto in discesa, dal momento che disponia- 
mo di una collection di oggetti che espongono la 
stessa interfaccia. Tutto quello che dobbiamo fare è 
passare gli eventi di PboxTela allo strumento corren- 
temente selezionato (in indice). 

Private Sub PBoxTela_MouseMove(Button As Integer, 

Shift As Integer, X As Single, Y As Single) 

Tools(indice).MouseMove Button, Shift, X, Y 
End Sub 

Qui sopra è riportato questo passaggio relativamen- 
te al metodo MouseMove; discorso identico (e stesso 
codice) vale per i metodi MouseUp e MouseDown. 
[File su CD: BaseApp. vbp, BaseApp.frm] 



CREAZIONE 
DEL PLUG-IN 

Il codice scritto nella sezione precedente impone 
gran parte delle scelte nella costruzione del plug-in. 
Questo non è necessariamente un male, anzi! 
Quando si fornisce un modello per sviluppatori 
esterni, non c'è niente di meglio che la standardiz- 
zazione di un metodo fisso e ben definito. Nel crea- 
re il nostro primo plug-in (lo strumento "Matita") 
vedremo che saranno proprio i vincoli esposti nel 
paragrafo precedente a farci da guida. Per il punto 1 
apriamo una nuova istanza di Visual Basic e selezio- 
niamo ActiveX DLL come progetto. Per il punto 2 
rinominiamo la classe predefinita Classi in CTool 
Per punto 3 andiamo in Project/Properties e cam- 
biamo il nome del progetto in "Matita". Aggiungia- 
mo al progetto un form SDÌ (PropForm) che fungerà 
da form delle proprietà. Ora dobbiamo soddisfare 
punto 4, ovvero far implementare a CTool l'interfac- 
cia ITool. Per questo, dopo aver stabilito una referen- 
ce di progetto ad ITool (come nell'applicazione di 
base) basta inserire all'interno della classe la riga 

Implements ITool 

Questo è sufficiente per creare dal nulla l'oggetto 
ITool, del quale - per "contratto" - siamo obbligati a 
implementare tutti i metodi. 

Implements ITool 

Private oldx As Long, oldy As Long 
Private m_Tela As PictureBox 
Private m_Nome As String 
Private m_PropertyForm As Form 
Public Sub Class_Initialize() 

m_Nome = "Matita" 

Set m_PropertyForm = PropForm 

oldx = -1: oldy = -1 




Uisual Basic 



Spesso i programmi 
più avanzati non si li- 
mitano a fornire una 
base di tipi, ma un in- 
tero sistema di 
sviluppo, o un API, che 
permetta un'in- 
tegrazione 

proprietaria: sovente, 
per scaricare l'SDK, 
viene richiesta l'ade- 
sione (a pagamento) a 
un network di svi- 
luppatori. Questo per- 
mette la nascita di so- 
cietà che si occupano 
esclusivamente di pro- 
gettazione di plug-ins 
per un programma 
specifico. 
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Nella scelta 

dell'architettura delle 

plug-in, occorre 

considerare anche il 

rischio a cui si espone 

il sistema nel caso di 

un componente 

'malevolo': 

un'interfaccia è 

sufficiente a obbligare 

l'uso di una struttura 

minima esterna, ma 

all'interno del codice 

associato è possibile 

prendere il totale 

controllo della 

macchina. Questo ci 

insegna a scaricare 

plug-in solo da fonti 

fidate, riconosciute, e 

con firma digitale - se 

non a codice aperto. 



End Sub 


Public Function ITool_GetIcon() As stdole.Picture 


Set ITooL 


_GetIcon = m_PropertyForm.Icon 


End Function 


Public Sub ITool_MouseDown(Button As Integer, Shift 
As Integer, X As Single, Y As Single) 


oldx = X: 


oldy = Y 


End Sub 


Public Sub ITool_MouseUp(Button As Integer, Shift As 
Integer, X As Single, Y As Single) 


oldx = -1 


: oldy = -1 


End Sub 


Public Sub ITool_MouseMove(Button As Integer, Shift 

As Integer, X As Single, Y As Single) 


If oldx = 


-1 And oldy = -1 Then Exit Sub 


If Button 


= vbLeftButton Then m_Tela.Line (oldx, 

oldy)-(X, Y) 


oldx = X: 


oldy = Y 


End Sub 



Il codice riportato qui sopra è la più semplice imple- 
mentazione possibile del nostro strumento. Ogni 
commento è superfluo, ad eccezione delle seguenti 
considerazioni: 

• Come avviene per ogni oggetto, i metodi di ITool 
vengono dichiarati anteponendo il nome del- 
l'oggetto seguito da underscore (ovvero: Sub 
ITool_Metodo) 

• Per esportare l'icona dello strumento abbiamo 
impostato un riferimento a quella del form delle 
proprietà (che assoceremo, quindi, all'immagi- 
ne di una matita) 

• Non abbiamo usato i campi definiti nell'inter- 
faccia, bensì delle variabili private. 

L'ultimo punto è degno di nota. Quando si imple- 
menta un'interfaccia, infatti, i campi da questa 
esposti divengono automaticamente delle proprie- 
tà, con relativi metodi (Property GetlSet). È quindi 
necessario creare delle variabili private a cui asso- 
ciare le relative proprietà. Questo, ad esempio, è il 
codice relativo alla proprietà Nome: 



Public Property Let ITooL 


Nome(ByVal 


RHS As Stri 


ig) 


m_Nome = RHS 


End Property 


Public Property Get ITooL 


_Nome() As String 




ITooLNome = m_Norr 


e 






End Property 



Dopo aver ripetuto questo noioso lavoro anche per 
le altre due proprietà [PBoxTela e PropertyForm), 
possiamo compilare (File/make), il nostro strumen- 
to che siamo tenuti a chiamare "Matita.DLL", e a sal- 
vare nella sottodirectory Strumenti. (File su CD: 
ToolMatita.vbp, ToolMatita.cls, ToolMatita.frm, 
StrumentilMatita.DLL). 



COMUNICAZIONE 
BILATERALE 

Dopo tanto lavoro, possiamo finalmente vedere la 
matita tracciare i suoi tratti sulla tela. Se ora volessi- 
mo sbizzarrirci, potremmo inventare migliaia di 
strumenti per la nostra applicazione: pennelli, car- 
boncini, aerografi con antialiasing, forme evolute, e 
via discorrendo... Tutto questo è molto divertente, 
ma in questa sede dobbiamo occuparci di cose più 
serie, come, ad esempio, rivedere il nostro modello 
d'interfaccia (dopo tanto lavoro!). Sussiste una serie 
di motivi per i quali il nostro sistema non è comple- 
to: innanzitutto la comunicazione applicazione-> 
plug-in è essenzialmente unilaterale: quando l'ap- 
plicazione chiama il plug-in, questo può solamente 
scrivere sulla tela, senza avere nessuna informazio- 
ne dal chiamante. E se, ad esempio, volessimo ag- 
giungere i colori al nostro disegno, per ora forzata- 
mente monocromatico? Dovremmo passarli nel 
messaggio o complicare ulteriormente l'interfaccia 
IToot? 

Tutti questi sistemi sono possibili, ma sconsigliati: 
quando non complicano il codice, infatti, rendono 
impossibile riutilizzo. L'idea da seguire, invece, è di 
creare un oggetto appObject che rappresenti, agli 
occhi dei plug-in, i servizi offerti dall'applicazione di 
base. Per fare un esempio pratico, creeremo il nostro 
secondo strumento: la linea 



I PROBLEMI DEL 
SiniGLE-BUFFERING 

Perché mai una linea dovrebbe causare tanti e tali 
problemi da imporre delle modifiche al modello 
d'interfaccia? In effetti, le differenze fra uno stru- 
mento "linea" e una "matita" sono davvero poche! 
In teoria basterebbe togliere l'aggiornamento dei va- 
lori oldx e oldy, nell'evento MouseMove, facendolo 
diventare: 

Public Sub ITool_MouseMove(Button As Integer, Shift 

As Integer, X As Single, Y As Single) 

If oldx = -1 And oldy = -1 Then Exit Sub 

If Button = vbLeftButton Then m_Tela.Line ( 

oldx, oldy)-(X, Y) 

End Sub 

In realtà il risultato di quest'intervento maldestro è 
ben differente, e visibile in Fig. 3: abbiamo inventa- 
to un nuovo strumento molto singolare, ma non è 
certo una linea! Il problema si verifica perché ad 
ogni movimento del mouse, non corrisponde un 
ridisegno della tela, ovvero un suo ripristino allo sta- 
to antecedente la chiamata al plug-in. Sarebbe di 
certo possibile inserire un PictureBox all'interno del 
componente, in cui salvare lo stato del disegno al 
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primo evento MouseDown, ma significherebbe spre- 
care inutilmente memoria e codice. In realtà, questo 
servizio è molto più efficace se offerto dall'applica- 
zione di base, la quale si suppone, peraltro, abbia già 
un bel po' di copie di scorta per le operazioni di 
undo. Per questo modificheremo leggermente l'ap- 
plicazione di base, inserendo nel form un buffer 
secondario, (nella fattispecie, un secondo Pic- 
tureBox di nome PBoxCopia, invisibile, delle stesse 
dimensioni di PBoxTela). Ora disponiamo di un 
backbuffer di appoggio: grazie all'API BitBlt potvemo 
passarne il contenuto al buffer primario. 



= SJ 



Milli» 




Fig. 3: Il pasticcio di linee derivante dal mancato ridi- 
segno della schermata ad ogni MouseMove. Problemi 
come questo si risolvono con un corretto backbuffering 



L'OGGETTO AppObject 

Ora che disponiamo di due buffer possiamo pensa- 
re al nuovo modello di comunicazione fra plug-in e 
applicazione di base. Sembra ragionevole pensare di 
passare ancora PBoxTela al plug-in, ma concedendo 
a quest'ultimo la possibilità di richiedere un ridise- 
gno del buffer (ovvero un trasporto di PBoxCopia in 
PBoxTela). Quando il plug-in avrà finito, e sarà sicu- 
ro del risultato, potrà notificare all'applicazione il 
compimento del lavoro. Possiamo, quindi, stabilire 
quest'interfaccia: 

Sub RequestRedrawQ 

End Sub 

Sub NotifyJobDoneQ 

End Sub 

Sono poche righe, ma ci saranno molto utili: an- 
dranno inserite in un nuovo modulo di classe (IAp- 
plicatiori) all'interno della nostra Type Library. 
Già che ci siamo, diamo anche un piccolo ritocco 
all'interfaccia ITool, aggiungendo l'oggetto: 

Public AppObject As IApplication 

Questo sarà a disposizione di ogni strumento, e per- 
metterà i servizi di richiesta di ridisegno e la notifica 
del lavoro compiuto. Una volta compilata la libreria, 



possiamo passare all'applicazione di base imple- 
mentando l'interfaccia, mediante l'aggiunta al codi- 
ce della riga: 

Implements IApplication 

Questo ci permetterà di definire i metodi antitetici 
(basati sulla GDI-API BitBlt): 



Private Sub IApplication 


_NotifyJobDone() 




With PBoxCopia 


BitBlt .hDC, 0, 0, 
.ScaleHeight, 


.ScaleWidth, 
PBoxTela. hDC, 0, 0, 


vbSrcCopy 


End With 


End Sub 


Private Sub IApplication 


_RequestRedraw() 




With PBoxTela 


BitBlt .hDC, 0, 0, .ScaleWidth, .ScaleHeight, 

PBoxCopia. hDC, 0, 0, vbSrcCopy 


End With 


End Sub 



Il primo fissa sul backbuffer il lavoro eseguito sul 
buffer primario, il secondo fa esattamente l'oppo- 
sto. Inoltre, dovremo far puntare la variabile ogget- 
to appObject di ogni plug-in all'applicazione stessa, 
all'interno del ciclo di caricamento in Form_Load, 
così: 

SetTools(i + 1). appObject = Me 

Dovremo infine occuparci di ridefinire sia la matita 
che la linea, aggiungendo la variabile private m_ap- 
pObject e le rispettive [property Get/Set], come ab- 
biamo imparato qualche paragrafo fa. 



Public Sub ITool_MouseUp(Button As Integ 
Integer, X As Single, 


er, Shift As 
Y As Single) 


oldx = -1: oldy = -1 


m_AppObject.NotifyJobDone 


End Sub 


Public Sub ITool_MouseMove(Button As Integer, Shift 

As Integer, X As Single, Y As Single) 


If oldx = -1 And oldy = -1 Then Exit Su 


b 


m_AppObject.RequestRedraw 


m_Tela.Line (oldx, oldy)-(X, Y) 


End Sub 



Ce l'abbiamo fatta: la nuova linea è esattamente co- 
me la precedente ma ha in più una richiesta di ridi- 
segno schermo per ogni MouseMove, ed una notifica 
di operazione compiuta per ogni MouseUp. 
Sono sicuro che tutte queste noiosissime modifiche 
sono servite da lezione per chiarire un concetto fon- 
damentale: occorre studiare molto un'interfaccia 
prima di implementarla! 

Roberto Allegra 
roberto.allegra@ioprogrammo.it 




Quando si crea una 
interfaccia, questa 
dovrebbe essere ben 
progettata, in maniera 
da 'resistere' 
elasticamente alle 
future esigenze 
dell'applicazione. 
Qualora un 
cambiamento sia 
inevitabile, è sempre 
buona norma lasciare 
immutata la classe o il 
metodo che si è deciso 
di modificare, e 
crearne uno nuovo, 
terminante per Ex (Es: 
IToolEx). Questo non 
risolve del tutto i 
problemi del "DM hell", 
ma tenta di porre un 
freno all'incompatibili- 
tà fra versioni diverse. 
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Convertire le GUI create in VB in codice Java 

Interfaccie grafiche 
da VB a Java 

Grazie al programma che svilupperemo sarà possibile trasformare 
il codice dei Form di Visual Basic in codice Java per realizzare 
interfaccie grafiche Swing 




□ CD □ WEB 

SwingCreator.zip 



™4* 



■■■■'■■•'■■■■'■■■"' 



n 




Conoscenze richieste 



— C# (basi), Web Services, 
L-l base in Java, base in 



Visual Basic 



I 



SDK 1.3 o superiore 



E^^^ai^a. 



Tempo di realizzazione 



eoe 



Il progetto che ci proponiamo di realizzare con il 
presente articolo è quello di realizzare un pro- 
gramma interamente scritto in Java che possa 
leggere i file sorgenti con estensione .frm prodotti 
dall'ambiente Visual Basic per poter codificare le 
interfaccie create in tale ambiente e trasformare il 
tutto in codice Java. Questo risulterà sicuramente 
utile a quanti di voi, avendo realizzato programmi in 
VB, volessero trasportare tutto nel linguaggio di Sun. 
Chi non avesse dimestichezza nella programmazio- 
ne di GUI, troverà sicuramente utile la lettura del 
codice in cui sono presenti numerosi spunti e spie- 
gazioni dei metodi più comunemente usati per rea- 
lizzare applicazioni grafiche. 




Fig. 1: Il programma in funzione 

UHI SGUARDO 
Al FORM VB 

Prima di cominciare è bene dare uno sguardo a 
come Visual Basic costruisce il codice per realizzare 
la grafica a video. Chi già programma in VB, solita- 
mente realizza le proprie interfacce senza preoccu- 
parsi di cosa ci sia dietro. Evitando di entrare in det- 
tagli troppo tecnici, diamo comunque un'occhiata a 
come viene codificato il codice di ciò che vediamo a 
video. Questo è indispensabile, in quanto il nostro 
programma non farà altro che leggere sequenzial- 
mente queste istruzioni e tramutarle in istruzioni 
valide per la JVM. 



Ogniqualvolta si avvia l'ambiente di sviluppo, viene 
creato un nuovo form di default. Questo rappresen- 
ta la finestra in cui lo sviluppatore andrà a inserire gli 
oggetti presenti sulla barra di sinistra. Il codice che 
VB genera a seguito delle operazioni dello sviluppa- 
tore non è visibile tramite la finestra Codice, ma se 
noi volessimo sapere come la nostra GUI è stata 
codificata dovremmo salvare il form in questione 
(ricordo che i form hanno tutti estensione .frm) e 
aprirlo tramite un semplice editor di testo (Blocco 
note di Windows va benissimo per questo scopo!) . Ci 
accorgeremmo che ogni oggetto viene codificato in 
VB tramite blocchi di codice contenuti nelle parole 
chiave "Begin VB." e "End". All'interno, inserite su 
più righe, sono presenti le varie proprietà per l'og- 
getto che si è disegnato. Ad esempio, se si volesse 
cambiare il testo di un pulsante, lo si potrebbe fare 
all'interno di questo file editando la riga in cui com- 
pare la scritta "Caption" ed inserendo il testo dopo 
simbolo =. 

Il nostro programma, quindi, non dovrà fare altro 
che aprire il file scelto, leggere ogni singola riga di te- 





File Modifica Formato Visualizza ? 


VERSION 5. DO 








Begin VB.Form swingcreator 




Caption 


= 


Swing Creator - IoProgr animo 




ci i entrici ght 


= 


3615 




ClientLeft 




50 




clientTop 


= 


4 SO 




Clientwidth 


= 


7665. 




LinkTopic 


= 


"Forni" 




ScaleHeight 


= 


3615 




scalewidth 


= 


7665 




StartUpPositi on 


= 


3 "Windows Default 




Begin VB.commandButton cmdcrea 




Caption 




= "Crea" 




Height 




375 




LEft 




6120 




Tablndex 




1 




Top 




3000 




width 




1335 




End 








Begin VB. Fraine 


panell 




caption 




convertitore di interfaccie 


grafiche da 


Height 




2655 




Left 




240 




Tablndex 









Top 




240 




width 




7215 




Begin VB.che 


ckB 


ox chkAnteprima 




Caption 




= Lancia 1 anteprima 




Height 




255 




Left 




120 




Tablndex 




9 




Top 




2280 




width 




3855 




End 









Fig. 2: Ecco come appare un file .frm una volta aper- 
to con un editor di testo qualsiasi 
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sto. Ogniqualvolta ci si trova di fronte ad una riga 
che inizia per "Begin VB." sapremo che quello è un 
nuovo oggetto da disegnare nella finestra. A questo 
punto, dovremo leggere ogni riga per recuperare le 
proprietà dell'oggetto finché non si arriverà alla riga 
riportante la parola "End". Le cose tendono a com- 
plicarsi leggermente quando, all'interno di un og- 
getto, troviamo un altro oggetto. Questo può essere 
il caso in cui un oggetto creato (quale ad esempio un 
TextBox) sia figlio di un altro oggetto (come un Fra- 
ine). Non preoccupiamoci troppo! Risolveremo il 
problema tramite una funzione ricorsiva. 



GLI OGGETTI 
TRATTATI 

Nella prima parte di questo articolo realizzeremo lo 
scheletro del nostro programma. Avremo così la 
possibilità di leggere GUI che contengono gli ogget- 
ti di Tab. 1. 



Visual Basic 


Java 


CommandButton 


JButton 


Label 


ILabel 


CheckBox 


ICheckBox 


OptionButton 


JRadioButton 


Fratrie 


IPanel 


JextBox 


ITextField A 


l Tabella 1: Le più semplici associazioni fra I due linguaggi 



Sono stati schematizzati i vari oggetti con il nome 
della classe in VB ed il nome della classe in Java. Il 
prossimo mese completeremo il tutto inserendo la 
codifica dei controlli "Image" e "Picture", dei menù e 
tratteremo il raggruppamento degli OptionButton 
che, come molti di voi sapranno, in Java devono es- 
sere associati ad un oggetto della classe Button- 
Group per poter essere legati tra di loro. 



TRE CLASSI 
FONDAMENTALI 

Per il nostro progetto ci awaleremo di tre classi fon- 
damentali: Oggetto, ScriviFile, SwingCreator. 
Ogni qualvolta incontreremo un nuovo oggetto nel 
file .firn, creeremo un'istanza di questa classe. Tale 
oggetto conterrà tutte le proprietà necessarie alla 
sua corretta visualizzazione. Quando vorremo pas- 
sare alla creazione del file .java, avremo un array 
contenente tutti gli oggetti da scrivere. 
La classe è composta da un insieme di proprietà 
tutte dichiarate di tipo String con il qualificatore pri- 
vate. È stato scelto di utilizzare tutte stringhe in 
quanto il valore di queste proprietà dovrà essere tra- 
scritto su file, quindi era inutile ogni volta effettuare 
un cast per tutti quei valori che dovrebbero essere 
numerici. Il qualificatore private, invece, ci permet- 



te di rendere inaccessibili tali dati dall'esterno della 
classe se non utilizzando i metodi get per leggere 
valore, e set per impostarne uno nuovo. Il metodo get 
ritorna una stringa mentre il metodo set accetta una 
stringa come unico parametro. Da notare inoltre, 
alcuni metodi set un po' particolari. Ad esempio: 

public void setWidth(String width) { 

int temp = Integer.parselnt(width) / 15; 
this. width = "" + temp; 

} 

Prima di registrare il valore nella variabile corrispon- 
dente, tale valore viene diviso per 15. Questo perché 
VB di default non utilizza i pixel come unità di misu- 
ra bensì i twips che sono appunto 1/15 dei pixel. 
Un'altra particolarità ci viene data dai due metodi 
setClientWidth e setClientHeight: 

public void setClientWidth(String clientWidth) { 

int temp = (Integer.parselnt(clientWidth) / 15) + 6; 

this. clientWidth = "" + temp; } 
public void setClientHeight(String clientHeìght) { 

int temp = (Integer.parselnt(clientHeight) / 15) + 32; 

this.clientHeight = "" + temp; 
} 

Nel metodo setClientWidth, al valore finale viene ag- 
giunto 6, così come nel metodo setClientHeight vie- 
ne aggiunto 32. Questo perché, mentre in Java la 
dimensione della finestra è data da tutto ciò che vie- 
ne disegnato a video, in VB questa dimensione rap- 
presenta l'area cosiddetta Client, cioè il pannello do- 
ve è possibile disegnare gli oggetti, ESCLUSO la zona 
dei Menu. Gli oggetti istanziatì dalla classe Oggetto 
posseggono un unico costruttore: 

public Oggetto(String tipo, String nome) { 

this. tipo = tipo; 

this. nome = nome; 

alignment = ""; 

caption = ""; 

enabled = ""; 

text = ""; 

toolTipText = ""; 

value = ""; 

visible = ""; 
} 

Tale costruttore accetta due argomenti che sono ri- 
spettivamente il tipo di oggetto che andremo a crea- 
re ed il nome con il quale verrà identificato all'inter- 
no del codice. Queste due variabili andranno ad es- 
sere inserite all'interno delle rispettive proprietà; 
sempre nel costruttore, inoltre, ci preoccuperemo di 
istanziare le proprietà che potrebbero non avere un 
valore all'interno del file .firn. La seconda classe che 
andiamo ad analizzare è la classe ScriviFile. Attraver- 





GLOSSARIO 



WRAPPERS 

Le classi 

BufferedReader e 
BufferedWriter 
utilizzano un buffer 
per memorizzare le 
informazioni da 
leggere e scrivere. 
Questo permette di 
ridurre gli accessi fisici 
al file. Tali classi 
vengono chiamate 
wrappers in quanto 
incapsulano all'interno 
oggetti delle classi 
FileReader e FileWriter 
estendendone le 
funzionalità. 



ISTANZA 

Con il termine istanza 
si intende la creazione 
fisica dell'oggetto. In 
pratica si ha un'istanza 
ogniqualvolta, dopo 
essere stato dichiarato, 
all'oggetto viene 
chiamata l'istruzione 
new. 
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GLOSSARIO 



SWING 

È la classe di Java per 
la creazione di interfac- 
cie grafiche. Estende le 
funzionalità della vec- 
chia awt la quale ha 
come difetto il fatto di 
essere dipendente dal 
sistema su cui gira 
l'applicazione. Quasi 
tutte le classi di ogget- 
ti grafici quali pulsanti, 
etichette.etc. sono 
state riscritte in swing 
interamente in Java. 
Trovate i sorgenti in 
\src\javax\swing\ 



GUI (Craphical 
User Interface) 

Con questo termine si 

vuole indicare tutte le 

finestre disegnate a 

video che permettono 

un'interazione con 

l'utente che le usa. 

Ogni programma è 

dotato di finestre 

attraverso le quali 

l'utente effettua le sue 

scelte. Windows stesso 

permette di accedere 

alle informazioni del 

proprio computer 

tramite GUI (Il desktop, 

ad esempio). 



so un'istanza di questa classe, si avrà la possibilità di 
creare il file .java contenente il codice della GUI 
estrapolata dal file diVB. 
I metodi di questa classe sono in tutto sei: 

1. public void intestazione(Oggetto obj[]); 

2. public int dichiarazioni(Oggetto obj[]); 

3. public void inserisciOggetto(Oggetto obj); 

4. public void pieDiPagina(Oggetto obj[]); 

5. public void setLookAndFeel(int laf); 

6. public void close(); 

Vediamo inanzitutto come creare un file in Java do- 
podiché analizzeremo i sei metodi esposti. 



I FILE IH! JAVA 

Per lavorare con i file in Java bisogna creare un cana- 
le attraverso il quale poter leggere oppure scrivere. 
Esistono svariate classi che ci permettono di fare 
questo. Nell'esempio seguente abbiamo creato il file 
utilizzando la seguente sintassi: 



file = 


= new File(percorso); 


pw = 


= new PrintWriter(new BufferedWriter( 

new FileWriter(file))); 



L'oggetto file fa riferimento ad un file fisico. Per 
istanziarlo al costruttore va passato il percorso del 
file che si vuole leggere oppure che si vuole creare. 
Dopodiché abbiamo istanziato l'oggetto pw della 
classe PrintWriter. Tale classe ci permette di scrivere 
su file utilizzando gli stessi metodi della classe Sy- 
stem.out. Quindi, se si volesse scrivere una stringa, la 
sintassi del comando sarebbe: pw.println(stringa);. 
Al costruttore abbiamo passato un oggetto della 
classe BufferedWriter che incapsula un oggetto della 
classe FileWriter che, a sua volta, incapsula l'oggetto 
file creato in precedenza. Sicuramente vi starete do- 
mandando come mai viene utilizzata questa tecnica 
di scatole cinesi. La risposta è semplice: per istanzia- 
re un oggetto della classe FileWriter abbiamo biso- 



C Ragion 9 so ci al 9 
O Cognome e nome 



Indirizzo 
C.A.P. 



J Fax 



L~ 



J cocl. fiscale Q 



Banca d'appoggio 
N. conto corrente 



J CAB 



D Inserisci cliente come fornitore 

D Registra negli appunti 

D Reno! disponibile anagrafica per modifiche 



gno di un oggetto File. Tale classe, però, ci permette 
solamente di scrivere un carattere alla volta. 
Possiamo ovviare a questo, istanziando un oggetto 
della classe BufferedWriter che possiede un metodo 
chiamato writeLineO per poter scrivere un'intera 
sequenza di caratteri. Per scrivere testo formattato, 
però, abbiamo bisogno di un oggetto PrintWriter 
che, come visto sopra, accetta come argomento al 
costruttore un BufferedWriter. Tutto chiaro allora? 
Come vedremo in seguito, per leggere dal file .frm 
ci fermeremo alla classe BufferedReader che con il 
suo metodo readLine() ci permette di leggere un'in- 
tera riga. 



CREIAMO 
IL FILE JAVA 

Vediamo, ora, come poter utilizzare i metodi di que- 
sta classe per creare un file java contenente il codice 
della GUI. Come prima cosa, per creare file, va 
istanziato un oggetto di questa classe dopodiché 
vanno chiamati i vari metodi nell'ordine esposto so- 
pra. I metodi dichiarazioni, intestazione, pieDiPagi- 
na richiedono come parametro un array di oggetti 
Oggetto. Tale vettore conterrà tutti gli oggetti creati 
che andranno inseriti nella nostra interfaccia. 
Il metodo intestazione fa da cappello al file java in 
quanto inserisce i vari package oltre a chiamare la 
classe con il primo oggetto dell' array (che sarà l'og- 
getto Form di VB) . Il metodo dichiarazioni permette, 
riconoscendo i singoli oggetti, di inserirne la dichia- 
razione nel file. In questa fase avviene la prima con- 
versione: ogni oggetto dell'array viene confrontato 
all'interno di un ciclo if, con una stringa contenente 
i tipi riconosciuti dal programma. Se viene trovata 
una corrispondenza, viene inserito nel file il codice 
appropriato. Ad esempio, se l'oggetto preso in que- 
stione fosse un TextBox di nome txtPercorso avremo 
che quando la JVM incontra l'istruzione 



else if(obj[i].getTipo().equals("TextBox")) 


pw.println(' 


private 


JTextField 


" + obj[i].getNome() 


verrà inserito 


nel file 


a stringa: 


private JtextField 

txtPercorso; 



Fig. 3: Tramite il programma è possibile codificare 
anche interfaccie complesse che altrimenti avrebbero 
richiesto molto tempo nello sviluppo 



Il metodo conclude inserendo un riferimento al 
Container, la classe che in Swing fa riferimento al 
pannello su cui verranno disegnati gli oggetti. Que- 
sto è da tenere a mente, infatti, quando analizzere- 
mo l'inserimento degli oggetti, ogni volta che un 
oggetto avrà come padre il Form, andrà aggiunto al 
Container con l'istruzione c.add(oggetto). 
Per aggiungere gli oggetti al file viene chiamato il 
metodo inserisciOggetto al quale passiamo come pa- 
rametro l'oggetto da inserire (e non l'array comple- 
to). Ogni oggetto viene fatto ciclare all'interno di 
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istruzioni if/else che controllano la proprietà tipo. Se 
l'oggetto viene riconosciuto correttamente, vengo- 
no inserite nel file le istruzioni in Java adeguate. In 
questa prima versione del programma, le proprietà 
riconosciute sono: 

Alignment 

Captìon 

Enabled 

Text 

ToolTipText 

Visible 

Chiude il metodo il seguente codice: 



// Aggiunta dell'oggetto al pannello 


if(obj.getTipoPadre(). 


equals("Form")) 








pw.println(spazio + 


"c.add(" + obj.getNomeO 


+ 


'); 


'); 


else 


pw.println(spazio + 


obj.getPadre() + ".add( 
" + obj.getNome() 


+ 


"); 


"); 



Per comprendere tale codice è indispensabile spre- 
care due righe nella spiegazione di come sono co- 
struite le interfaccie in Java. Per essere brevi si po- 
trebbe paragonare il Form diVB al Container di Java. 
Tale Container definisce l'area della finestra in cui è 
possibile inserire i vari oggetti grafici quali pulsanti, 
etichette, etc. Essendo Container la superclasse di 
tutti gli oggetti grafici possiamo dire che anche que- 
sti ultimi sono essi stessi contenitori, quindi, volen- 
do, è possibile inserire, ad esempio, un pulsante al- 
l'interno di un pulsante. Questo fa sì che si crei una 
gerarchia Padre/Figlio dove il padre è appunto il 
contenitore che ospita l'oggetto Figlio. Tale gerar- 
chia è evidente tra il Container ed i vari oggetti; in- 
fatti per disegnare un oggetto a video si utilizza il 
metodo addo applicato al container; ma è anche 
possibile trovarsi di fronte ai casi in cui l'oggetto 
venga disegnato all'interno di un Frame (JPanel in 
Java). In questo caso va prima aggiunto l'oggetto al 
pannello con 

nomePannello.add(oggetto); 

dopodiché verrà aggiunto il pannello al container 
con 

nomeContainer.add(pannello); 

Nel codice sopra riportato è evidente che nel caso in 
cui la proprietà tipoPadre è uguale a "Form", tale 
oggetto verrà aggiunto direttamente al Container; in 
caso contrario verrà aggiunto all'oggetto padre. 
Gli ultimi due metodi di questa classe sono setLook- 
AndFeel e dose. Il primo sfrutta una caratteristica 
delle interfaccie Swing, quella, cioè, di poter dise- 
gnare le GUI a video mantenendo l'aspetto tipico di 



Java (settato di default), oppure assumendo l'aspet- 
to tipico delle interfaccie Windows o Linux. Il secon- 
do, invece, chiude il file e va chiamato alla fine del 
programma. Se ci dimenticassimo di chiamarlo ver- 
rebbe solamente creato un file vuoto, in quanto tale 
metodo permette di scaricare su file tutte le infor- 
mazioni precedentemente bufferizzate. Prima di 
chiamare questo metodo va però chiamato il meto- 
do pieDiPagina che ci permette l'inserimento delle 
istruzioni di dimensionamento della nostra finestra. 



IL CUORE 

DEL PROGRAMMA 

Passiamo alla spiegazione della classe SwingCreator, 
la quale, oltre a contenere il metodo main, è il fulcro 
intorno al quale si muove tutto il software. 
Il costruttore di tale classe viene usato per costruire 
la GUI del programma. Per coerenza, le istruzioni 
sono state ricavate direttamente da questo pro- 
gramma! Ci sono chiaramente delle aggiunte che 
riguardano la gestione degli eventi come ad esempio 
è possibile selezionare il file .firn da convertire clic- 
cando sul pulsante Apri. Questo ci aprirà un oggetto 
appartenente alla classe JfileChooser che ci permet- 
te di navigare all'interno del FileSystem del nostro 
computer. Per l'inserimento del logo di ioProgram- 
mo si è ricorsi ad un piccolo trucco: si è creato un 
oggetto della classe Imagelcon, dopodiché lo si è 
associato ad una label senza testo. Esistono maniere 
più eleganti per l'inserimento di immagini in un 
Container, ma questo è sicuramente il più veloce. I 
due metodi principali di questa classe (i quali sono 
cuore di tutto programma) sono i seguenti: 

private void iniziaConversioneQ 

private void inserisciOggetto(String obj, String padre, 
String tipoPadre, BufferedReader br) throws 

IOException 

Entrambi i metodi sono dichiarati private, questo 
perché non devono essere accessibili al di fuori di 
questa classe. Come vediamo, anche il metodo inse- 
risciOggetto rimanda al chiamante la gestione del- 
l'eccezione IOException. Sarà infatti compito del 
metodo inizaConversione, gestire tutti i problemi di 
input/output; questo fa si che il corpo del metodo 
sia racchiuso all'interno dei blocchi trylcatch. 
Il corpo di questo metodo è semplicissimo da com- 
prendere: viene aperto file .firn in lettura viene fat- 
to ciclare una prima volta per verificare la quantità 
di oggetti totali al fine di dimensionare correttamen- 
te l'oggetto Oggetto, dopodiché viene eseguito un 
ulteriore ciclo, questa volta utile per il riconosci- 
mento dei vari oggetti e l'inserimento degli stessi nel 
file Java. In pratica, ad ogni ciclo viene letta un'inte- 
ra riga tramite il metodo readLine della classe Bufi 




COMPILAZIONE 

Per compilare i 
programmi scritti in 
java, i sorgenti devono 
essere salvati su disco 
con estensione java. 
Accertatevi che tutte e 
tre le classi siano 
presenti nella 
medesima cartella, 
dopodiché, dalla 
finestra DOS, dopo 
esservi portati nella 
cartella ove risiedono i 
file, digitate il 
comando javac 
SwingCreator. java. 
Se non viene segnalato 
alcun errore significa 
che il programma è 
stato compilato 
correttamente. 
A questo punto per 
avviarlo digitate java 
SwingCreator. 



http://www.ioprogrammo.it 



Novembre 2004/ 37 ► 



TEORIA & TECNICA 



Cooperazione fra piattaforme 




VARIABILI 
D'AMBIENTE 

Per poter utilizzare i 
comandi javac e java 
da quasiasi posizione ci 
si trovi bisogna impo- 
stare la variabile d'am- 
biente PATH con il per- 
corso corretto ove si 
trovano i programmi. 
Per accedere al pan- 
nello di modifica 
cliccare su 
Start/Pannello di 
ControllolSistemalAvan 
zatelVariabili d'am- 
biente. Si presenterà la 
schermata di Fig. 4. 
Da qui è possibile mo- 
dificare o aggiungere 
variabili tramite i pul- 
santi Nuovo e 
Modifica. 
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feredReader, dopodiché viene utilizzato il metodo 
indexOfdeìla. classe Stringa quale accetta come pa- 
rametro la stringa che vogliamo ricercare all'interno 
della stringa alla quale viene applicato il metodo e 
ritorna -1 se non viene trovata, oppure l'indice alla 
quale tale sottostringa ha inizio. A questo metodo 
noi passeremo la stringa Begin VB. che indica l'inizio 
di un nuovo oggetto. Se il valore ritornato dal meto- 
do sarà diverso da -i verrà chiamato il metodo inse- 
risciOggetto che permette di estrapolare le varie in- 
formazioni riguardanti l'oggetto ed inserirle nell'og- 
getto Oggetto. 

Il metodo si conclude creando un'istanza della clas- 
se ScrìviFile che, come detto sopra, ci servirà per 
compilare il file in formato Java in quanto, a questo 
punto del programma, avremo tutte le informazioni 
che ci interessano contenute all'interno del nostro 
array di oggetti Oggetto. 



COME CREARE 
I VARI OGGETTI 

Ma il fulcro di tutto è il metodo inserisciOggetto! 
Tale metodo legge le righe dal file VB, estrapola le in- 
formazioni e, dopo aver creato un'istanza di Oggetto, 
compila le proprietà che saranno codificate in lin- 
guaggio Java dalla classe ScrìviFile. 
Vediamo come: 

StringTokenizer token = new StringTokenizer(obj); 
tipo = token. nextToken(); 
nome = token. nextToken(); 
oggetto[indice] = new Oggetto(tipo,nome); 
padreTemp = oggetto[indice].getl\lome(); 
tipoPadreTemp = oggetto[indice].getTipo(); 
oggetto[indice].setPadre(padre); 
oggetto[indice].setTipoPadre(tipoPadre); 

A questo metodo viene passata la stringa letta dal 
file (obj), l'identificatore padre e tipoPadre, e l'og- 
getto BufferedReader per continuare a leggere nel 
file letto. Come primo passaggio viene creata un'i- 
stanza della classe StringTokenizer la quale ci per- 
mette di dividere una stringa in token, vale a dire 
parole separate da un carattere predefinito. 
Nella sua forma più semplice, come carattere vie- 
ne utilizzato lo spazio. Questo significa che la frase 
Programmare in Java viene divisa in tre token: 

Programmare 

in 

Java 

A noi risulta utile in quanto nella riga contenente la 
dicitura Begin VB. è presente anche il tipo di oggetto 
ed il nome assegnatogli in fase di progettazione. Tali 
parametri vengono passati al costruttore di Oggetto 



per creare correttamente l'istanza. Vengono asse- 
gnate anche le proprietà padre e tipoPadre che iden- 
tificano l'oggetto nella gerarchia di scatole cinesi so- 
pra esposta. Invece alle due variabili temporanee 
vengono assegnati i nomi dell'oggetto corrente. 
Questo perché nel caso in cui nelle precedenti lettu- 
re del file .firn non venisse riscontrata la chiusura 
dell'oggetto tramite la dicitura End, bensì nuova- 
mente Begin. VB, significherebbe che il nuovo ogget- 
to che andremo a creare sarà figlio dell'oggetto non 
ancora chiuso. Infatti per risolvere il problema degli 
oggetti annidati uno dentro l'altro, la funzione 
inserisciOggetto è stata costruita utilizzando la ricor- 
sione: ogni riga dell'oggetto viene letta fino a quan- 
do non si incontra la dicitura End. 
Ad ogni lettura vengono confrontate le proprietà 
lette con quelle riconosciute dal programma. In caso 
positivo, tali proprietà vengono inserite nell'oggetto 
Oggetto. 

Se durante una nuova lettura viene riscontrata la di- 
citura Begin VB. viene nuovamente richiamato il me- 
todo inserisciOggetto, e così fino alla fine del file. 
Un altro metodo presente nella classe è elimina- 
Apici: 



private String 


BliminaAp 


ci(String stringa) { 


String temp 






int idTemp = 


0; 




for(int i = 


i < string 


a.length();i + + ) 


if( stringa 


charAt(i) 


!= "") 


temp 


= temp + 


stringa. charAt(i); 


return temp; 


} 



Tale metodo accetta in ingresso una stringa e resti- 
tuisce la stessa privata dei doppi apici. Questo risul- 
ta utile per le proprietà quali Caption, Text, ToolTip- 
TextH cui valore, all'interno del codice VB è compre- 
so appunto tra apici. 



CONCLUSIONI 

Per questo mese basta così. Il programma proposto 
fino a questo punto è perfettamente funzionante, 
anche se permette la conversione di interfacce 
limitate. Il prossimo mese vedremo di estenderne 
le potenzialità come ad esempio il riconoscimento 
dei menù e l'inserimento di grafica quali linee, ret- 
tangoli, etc. 

Per il momento, chi volesse, può effettuare le sue 
prove direttamente sui Form forniti insieme all'ap- 
plicazione (per visionare i Form è necessario avere 
installato l'ambiente di sviluppo Visual Basic). 
Buono studio e soprattutto buon divertimento nella 
creazione delle vostre GUI! 
Alla prossima! 

Alessandro Baldini 
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WordML e XPath per aggiornare feed RSS 

Pubblicare via RSS 

parte seconda 

WordML è il nuovo formato standard di Microsoft Word. 
Impareremo a interpretarlo e a pubblicare su Internet i contenuti 
dei nostri documenti tramite il protocollo dei Blog: RSS 



Nella scorsa puntata avevamo visto cosa è un 
feed RSS e come possiamo utilizzare .NET 
per produrre feed. Il nostro progetto era in- 
fatti quello di aggiungere ad una applicazione web 
la possibilità di produrre dei feed a partire dalla pre- 
senza di nuovi file in un repository di documenti. 
Utilizzando la caratteristica di salvataggio XML di 
Word 2003 potremo realizzare un servizio che faccia 
quanto ci serve. Utilizzeremo varie tecniche della 
programmazione OOE tra cui il polimorfismo, l'ere- 
ditarietà e l'uso di interfacce. Capiremo come utiliz- 
zare i servizi del framework .NET per monitorare la 
modifica dei file in una cartella. Illustreremo come 
creare una architettura estensibile e aperta. 
Vedremo come è strutturato un file WordML e come 
utilizzare XPath per estrarre informazioni. Tutto 
questo porterà allo sviluppo di una applicazione 
che produrrà automaticamente il file RSS aggiorna- 
to. 



L'ARCHITETTURA 
DEL SISTEMA 

Possiamo vedere l'architettura del sistema che an- 
dremo a realizzare sotto due punti di vista: la se- 
quenza delle azioni che verranno prodotte, quindi 
una vista dinamica, e la struttura delle classi utiliz- 
zate, quindi una vista statica. In Fig. 1 vediamo un 
diagramma di stato che mostra gli stati principali in 
cui si trova il nostro servizio, in relazione alle opera- 
zioni che verranno effettuate. Queste operazioni 
sono schematizzate in Fig. 2. In sintesi: 

1. il nostro servizio viene attivato; 

2. un redattore produce un articolo in Word 2003; 

3. l'articolo viene salvato in un repository, nel 
nostro caso una cartella; 

4. il servizio si accorge che è stato aggiunto un 
nuovo file alla cartella, e quindi inizia proces- 
so di estrazione delle informazioni dai file; 

5. il servizio produce il file XML contenente iìfeed 
RSS; 

6. il file viene pubblicato. 



Per repository intendiamo un qualunque luogo "lo- 
gico" in cui i redattori possono salvare i loro articoli 
WordML. Potremmo utilizzare un database, o un si- 
to che espone un web service o anche un server FTP 
Da un punto di vista statico, il nostro servizio avrà 
bisogno di alcuni componenti di base, come si evin- 
ce dal diagramma delle sequenze della Fig. 3: una 
classe che realizzi il servizio; una classe che si occu- 
pi di sorvegliare il repository per informare il servi- 
zio di nuovi arrivi e per passare i documenti al servi- 
zio stesso; una classe che si occupi di gestire la pro- 
duzione del file RSS, utilizzando fra le altre la classe 
RSS20 la cui struttura è già stata vista nella scorsa 
puntata; una classe estrattore, il cui scopo è quello 
di fare il parsing vero e proprio e quindi di estrarre le 
parti salienti dal documento WordML perché siano 
inserite nel feed RSS. 



ESTENSIBILITÀ 

Esaminando le considerazioni fatte nel paragrafo 
precedente ci rendiamo conto che sarebbe interes- 
sante progettare il sistema perché possa essere 
estensibile almeno in tre direzioni: 

• Gestione di più tipi di repository. 

• Gestione di più formati di file in input. 

• Gestione di differenti strategie di individuazione 
ed estrazione delle parti interessanti dal testo. 

Per realizzare quanto descritto non andremo a scri- 
vere il nostro codice facendo diretto riferimento a 
classi, ma riferendoci ad interfacce. Definiremo due 
interfacce che esporranno tutte le caratteristiche 
comuni delle classi volute: 

IRepositoryWatcher: verrà implementata dalla 
classe che farà comunicare la nostra applicazione 
con il repository. Suoi compiti saranno: 

• sorvegliare il repository per avviare l'aggiorna- 
mento del file RSS qualora ci siano nuovi file o 
gli esistenti vengano modificati; 

• fornire alla classe produttrice dell'RSS i conte- 
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Fig. 1: Diagramma di 
stato del servizio 



REQUISITI 



H.1.UWJJJJ 



— Elementi di XML 
U e. NET 



| .NET Framework, 
preferibilmente Visual 
Studio .NET 




http://www.ioprogrammo.it 



Novembre 2004/ 39 ► 



TEORIA & TECNICA 



Pubblicazione dei dati 




nuti dei file. In questo modo la vera natura del 
repository verrà nascosta al resto del program- 
ma. Così facendo, per esempio, grazie al poli- 
morfismo la struttura del servizio non saprà se 
sta utilizzando la classe che prende i file dal file- 
system o quella che invece li scarica da un sito 
FTP: saprà soltanto che sta utilizzando una clas- 
se che implementa l'interfaccia IRepositoryWat- 
cher. 

IContentExtractor: rappresenta la classe che estrae 
dal documento i contenuti che servono per produr- 
re l'item RSS. Questa interfaccia è molto utile, in 
quanto potremmo progettare in seguito algoritmi 
più sofisticati di individuazione delle parti del testo. 
Se la classe che li realizzerà implementerà anche 
IContentExtractor potrà essere utilizzata senza mo- 
difiche al codice chiamante. 



Classe 


Responsabilità 


Deriva da 


Coordinatore 


Si occupa di coordinare le varie classi. 
Dà l'inizio al processo di sorveglianza del 
repository, e chiama il produttore RSS 
assegnando il ContentExtractor corretto 




SimpleWordMLContent 
Extractor 


Ha lo scopo di estrarre i dati da files in 
cui i dati siano salvati in un file WordML 
e contrassegnati da particolari stili 


realizza l'interfaccia 
IContentExtractor 


SimpleTextContent 
Extractor 


Ha lo scopo di estrarre i dati da files in cui 
i dati siano disposti ognuno su una riga 


realizza l'interfaccia 
IContentExtractor 


ComplexTextContent 
Extractor 


Ha lo scopo di estrarre i dati da files in 
cui i dati siano fra tags: per esempio 
<TITOLO> ciao </TITOLO> utilizza le 
regular expressions 


realizza l'interfaccia 
IContentExtractor 


WatcherCartella 


Una IRepositoryWatcher che ha come 
repository una cartella di fllesystem 


realizza l'interfaccia 
IRepositoryWatcher 


RSS20 


La classe vista nello scorso numero, 
realizza il file RSS 




RSSProducer 


Si occupa di produrre il file RSS tramite 
la classe RSS20 




FileDaRepository, 
DatìArticolo 


Classi helper 




i Tabella 1: Classi principali del programma 
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Fig. 2: Le operazioni effet- 
tuate dai servizio 



Le classi principali realizzate per il programma, e le 
loro responsabilità, sono riportante nella Tab. 1. 
Nel CD e/o sul Web, troverete anche un file .ehm con 
la documentazione completa delle classi, dei meto- 
di e dei delegati realizzati. 



CONTROLLARE 
IL REPOSITORY 

La classe che implementa l'interfaccia IRepository- 
Watcher deve poter informare il programma quan- 
do si ha un cambiamento nel repository. Nel nostro 
esempio il repository è il file system locale. Ci viene 
quindi in aiuto la classe del Framework .NET File- 
SystemWatcher. Questa classe fa proprio al caso no- 
stro, infatti sorveglia una cartella, o un ramo di car- 
telle, e alza degli eventi in base ai cambiamenti. 
Utilizzeremo questa classe in modo asincrono all'in- 
terno della classe WatcherCartella, impostandone a 
true la proprietà EnableRaisingEvents. Resterà solo 



da registrare i nostri gestori agli eventi del FileSy- 
stemWatcher e il gioco sarà fatto. Nel corpo della 
classe sono presenti anche due metodi, Comincia- 
EnumerazioneFilesO e ProssimoFileO che vengono 
utilizzati per scorrere e per estrarre i file dal reposi- 
tory. Ecco il codice della classe: 

public class WatcherCartella: IRepositoryWatcher 

{ //fields 

string _Path; 

FileSystemWatcher _FSW; 

FileInfo[] _Files; 

int _FileCorrente; 

/// <summary> 

/// costruttore 

/// </summary> 

/// <param name="Path">il path della cartella 

repository </param> 
public WatcherCartella(string Path) 

{ _Path = Path; 

_FSW= new System. IO. FileSystemWatcher(Path); 

_FSW.Filter ="*.*"; 

_FSW.NotifyFilter =NotifyFilters.LastAccess | 
NotifyFilters.LastWrite 
| NotifyFilters.FileName | NotifyFilters.DirectoryName; 
_FSW.Deleted+=new FileSystemEventHandler( 

_FSW_Deleted); 
_FSW.Created +=new FileSystemEventHandler( 

_FSW_Created); 
_FSW.Changed +=new FileSystemEventHandler( 
_FSW_Changed); } 
//per info su questi metodi si veda la dichiarazione 

di interfaccia 
#region IRepositoryWatcher Members 
public void CominciaAControllare() 
{ _FSW.EnableRaisingEvents=true; } 
public void Smetti() 
{ _FSW.EnableRaisingEvents=false;} 
public void CominciaEnumerazioneFilesO 
{ Directorylnfo DI= new Directorylnfo (_Path); 

_Files = DI.GetFilesQ; 

_FileCorrente=0; } 
public FileDaRepository ProssimoFileO 
{ ■■■} 



Coordinatore 


Controllore rerxreitorv 


Produttore RSS 


EstratloreCofilenuto 







I 



Controlla rapositor ■ 



Aggiorna RSS 

H 

Comincia Enumerazione Files 

F 1 

DarnmiProssi moFile 



par ogni fila 



C 



Fig. 3: Componenti di base del servizio 
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WORDML: XML 
PER I DOCUMENTI 

WordML, che sta per WordprocessingML, è un dia- 
letto XML creato per descrivere in maniera aperta 
un documento, nel caso specifico un documento 
Word. Il fatto che sia XML ci porta alle seguenti con- 
siderazioni: 

• Possiamo utilizzare gli strumenti XML del fra- 
mework .NET per fare il parsing del documento. 

• Le nostre considerazioni varranno anche per 
documenti non Word, purché conformi allo 
schema WordML. 

• Sarebbe interessante che il nostro sistema fosse 
espandibile, per poter implementare migliori 
strategie di rilevamento delle parti del testo. 

Per poter esaminare i file XML che ci verranno sot- 
toposti, occorre conoscere lo schema e il significato 
degli elementi che compongono un file WordML. 
Lo schema di WordML è piuttosto complesso: intro- 
durremo qui le caratteristiche di base che ci baste- 
ranno per un esame rozzo ma efficace di documen- 
ti ben strutturati. Nei riferimenti riportati a lato tro- 
verete una documentazione più dettagliata ed utile 
ad utilizzi professionali. I principali elementi di alto 
livello in un documento WordML sono l'elemento 
mot: wordDocument e gli elementi figlio indicati 
nella Tabella 2. Infine, vero e proprio corpo del 
documento, l'elemento body, il contenuto del docu- 
mento. All'interno di questo, una serie di elementi, 
che vanno a definire le sezioni, gli stili, e i paragrafi, 
tutti elencati nella Tabella 3. Quindi il più semplice 
documento WordML potrebbe essere: 

<?xml version = "1.0"?> 

<?mso-application progid = "Word.Document"?> 

<w: wordDocument 

xmlns:w=http://schemas. microsoft.com/office/word 
/2003/wordml xmlns:o="urn:schemas-microsoft-com: 

office: office" > 
<o:DocumentProperties> 

<o:Title>II primo articolo</o:Title> 
<o:Author>Marco Poponi </o:Author> 
</o:DocumentProperties> 
<w:body> <w:pxw:r> 

<w:t>II mio articolo</w:t> 
</w:r> </w:p> 
</w:body> 
</w: wordDocument 

In cui è presente solo un pagarafo di stile Normale 
(quindi senza specifiche di stile) e con testo: Il mio 
articolo. Si noti la processing instruction <?mso-ap- 
plication progid="Word.Document"?> che istruisce 
Internet Explorer a non aprire normalmente il file 
XML ma a passarlo a Word. È opportuno notare che 



queste informazioni non servono solo per leggere 
un file WordML prodotto da Word, ma possono es- 
sere utilizzate anche per produrre un file che Word 
può leggere. 



L'ESTRAZIONE 

La complessità e l'efficacia dell'algoritmo di estra- 
zione del contenuto del file dipendono in gran parte 
da due fattori: 



1. quanto e come è strutturato il file di partenza; 

2. quali informazioni devono essere estratte. 

Nel nostro esempio supporremo che il redattore 
faccia un uso avveduto degli stili, ovvero che assegni 
uno stile conosciuto e preciso ad ogni parte dell'ar- 
ticolo. Per esempio, titolo sarà realizzato nello stile 
TitoloPrincipale, mentre il riassunto sarà, appunto, 
realizzato nello stile Riassunto e così via. In Fig. 5 è 
riportato lo schema di massima dell'algoritmo uti- 
lizzato. L'estrazione delle informazioni viene fatta 
attraverso l'uso di query XPath. Per quanto riguarda 
l'estrazione delle informazioni presenti sul nodo 
DocumentProperties sarà una query sul nome del 
nodo, per quanto riguarda invece i dati nel corpo 
del documento la query sarà più complessa, e farà 
riferimento al nodo di stile figlio del nodo paragrafo. 
Il codice della classe che estrae i dati WordML sarà 
(in neretto le query XPath): 

public class SimpleWordMLContentExtractonIContentExtractor 
{ private XmlDocument XDoc; 

/// <summary> 

/// Metodo che utilizza una query XPath per estrarre 

tutto il testo dell'articolo 
/// che ha un certo stile passato come param 
/// </summary> 
/// <param name="Style">lo stile da usare per la 

query</param> 
/// <returnsx/returns> 
private string EstraiDato(string Style) 
{ //devo definire un XmlNamespaceManager per 

gestire i namespaces nella query 
XmlNamespaceManager XMLNS= new 

XmlNamespaceManager(XDoc.NameTable); 
XMLNS.AddNamespace("o"," 

urn:schemas-microsoft-com: office: office"); 
XMLNS.AddNamespace("w","http://schemas. 

microsoft.com/office/word/2003/wordml"); 

//la query XPath 

string 

XQuery=@"/w:wordDocument/w:body//*/w:p[ 
descendant::*[@w:val='STILE']]//*/w:t"; 
XQuery= XQuery.Replace("STILE", Style); 
XmlNodeList Nodelist = (XDoc.SelectNodes( 

XQuery,XMLNS)); 




• Elemento 
documentProperties: 

qui sono presenti utilis- 
sime informazioni sul 
documento, quali auto- 
re, data ecc. 



• Elemento fonts: infor- 
mazioni sui font. 



• Elemento list: defini- 
zioni di stili di lista. 



• Elemento styles: defi- 
nizioni degli stili utiliz- 
zati nel documento. 



• Elemento docPr: 

opzioni generali del 
documento. 



Tabella 2: Eli elementi figlio 
di wordDocument 



• Elemento p: un para- 
garafo 



• Elemento r (run): un 

insieme contiguo di ele- 
menti WordML omoge- 
nei per proprietà 



• Elemento t: un brano 
di testo 



• Elemento pStyle: ini- 
zio di uno stile. 



Tabella 3: Sii elementi che 
compongono il body 
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SUL WEB 



http://msdn.microsoft,com 

/office/understanding/xml 

office/tools/default.aspx 

il centro msdn di 

download degli 

strumenti su XML in 

Office. Consiglio 

fortemente il primo 

download. Office 2003 

XML Reference 

Schemas in cui è 

possibile trovare una 

completa 

documentazione su 

WordML. 

http://msdn.microsoft,com 

/office/understanding/xml 

office/defaultaspx 

il centro msdn sull'uso 

di XML in Office 

http://sourceforge.net/ 

projects/xpe/ 

XPath Explorer, un 

semplice ma potente 

programma Java Open 

Source che permette di 

provare query XPath su 

file XML. 




I FILE NEL CD 

Nel CD e sul sito Web 
allegato alla rivista è 
presente il codice sor- 
gente dell'aplicazione 
completa descritta in 
questo articolo, dei file 
di esempio e un file di 
documentazione 
completo delle classi 
presenti 
nell'applicazione. 



//ciclo fra tutti i nodi trovati ed estraggo il testo 

string ret=""; 

if (Nodelist.Count!=0) 

{ foreach(XmlNode Nodo in Nodelist) 

{ ret+ = (Nodo as XmlElement).InnerText ;} 

} return ret; } 

#region IContentExtractor Members 

/// <summary> 

/// estrae i dati, utilizzando query XPath 

/// </summary> 

/// <param name="FileDaEstrarre"x/param> 

/// <returnsx/returns> 

public DatiArticolo EstraiArticolo(FileDaRepository 

FileDaEstrarre) 
{ if (FileDaEstrarre. Nome. EndsWith(". xml")) 

{ //carico il documento in un doc XML 

///utilizzo una semplice query XPath per estrarre i dati 
Dati.Autore=(XDoc.SelectSingleNode("//o:Author", 

XMLNS) as XmlElement ).InnerText ; 

Dati.DataPubblicazione=(XDoc.SelectSingleNode( 
"//o:Created", XMLNS) as XmlElement ).InnerText ; 
///richiamo una query XPath più complessa per 

estrarre i dati nel corpo del testo 
Dati .Titolo = Est raiDato("TitoloArticolo"); 
Dati.URLDiPubblicazione=EstraiDato( 

"URLPubblicazione"); 

Dati. Riassunto= Estrai Dato(" Riassunto"); 
return Dati; } 

else 

{ return nuli; } } #endregion } 



ESTENSIBILITÀ 

Abbiamo deciso di realizzare una applicazione Win- 
dows Forms (e non un servizio, come sarebbe stato 
più ortodosso se il progetto fosse andato in produ- 
zione) per permettervi di sperimentare quanto 
abbiamo visto in pratica, specialmente l'estensibi- 
lità. L'interfaccia grafica dell'applicazione (vedi Fig. 
6) permette di specificare quale sia il repository (la 
cartella nel nostro caso) da utilizzare, il path in cui 
verrà salvato il file RSS prodotto e soprattutto quale 
classe IContentExtractor verrà passata al Coordina- 
tore. Per mostrare in maggiore dettaglio il meccani- 
smo di estensibilità adottato sono state scritte altre 
due classi che estraggono il contenuto di un artico- 
lo oltre a quella per il formato WordML. La prima, 
SimpleTextContentExtractor, assume che le varie 
informazioni siano presenti in un file di testo su 
righe diverse. La seconda, ComplexTextContentEx- 
tractor, si aspetta, invece, un file .txtc un po' più 
strutturato, in cui i dati utili siano scritti fra tagXML 
(esempio: <TITOLO> questo è il titolo</TITOLO> ) 
ed utilizza Regular Expressions per operare il par- 
sing. Nessuna delle classi che realizzano il program- 
ma è al corrente a quale classe appartenga l'oggetto 



derivante da IContentExtractor che verrà utilizzato. 
Nel nostro esempio è l'interfaccia grafica che sceglie 
quale classe implementare e passare al Coordinato- 
re a seconda dell'input dell'utente. Questo permet- 
te, qualora si individui un algoritmo più raffinato, o 
si cambi il formato dei file, di aggiornare l'intero 
programma semplicemente scrivendo una nuova 
classe: tutto il resto continuerà a funzionare 



GENERATORE DI RSS 

Abbiamo visto nello scorso numero come scrivere 
una classe che realizzi facilmente un file RSS. Nel 
nostro progetto questa classe verrà utilizzata nel 
modo che conosciamo dalla classe RSSProducer. 
RSSProducer utilizzerà inoltre i servizi della IReposi- 
toryWatcher per enumerare ed estrarre i file dal re- 
pository: 

RWatcher.CominciaEnumerazioneFiles(); 

FileDaRepository FDR= _RWatcher.ProssimoFile(); 

while(FDR! = null) 

{ (...) aggiunge l'item 

FDR= RWatcher.ProssimoFile(); } 

E poi salverà il file in un modo un po' diverso da 
quanto visto nel numero scorso, infatti utilizza Xml- 
TextWriter che ci permette di specificare l'encoding 
per il file XML generato. Lo vediamo nel seguente 
brano di codice, in cui RSS è l'oggetto che realizza il 
file RSS: 

XmlSerializer Ser= new XmlSehalizer(typeof(rssClass)); 
System. Xml. XmlTextwriter XMLTW= new System. Xml. 
XmlTextWriter(path , System.Text. Encoding. UTF8); 

Ser.Serialize(XMLTW,RSS); 

XMLTW.CIose(); 



CONCLUSIONI 

Abbiamo quindi realizzato tutti gli elementi che ci 
servono per la costruzione del nostro progetto. Non 
ci resta che "assemblarli" in maniera che il tutto 
funzioni. Il cuore del progetto sarà la classe Coordi- 
natore che, appunto, coordinerà tutte le altre classi. 
Analizziamo tre metodi di questa classe: 

1. Il costruttore, che prende come parametro la 
IContentExtractor da utilizzare. 

2. Il metodo che dà inizio al processo. 

3. Il metodo che viene richiamato quando si ha un 
nuovo file e si occupa di aggiornare il file RSS. 

Il risultato lo trovate nella classe costruttore, presen- 
te nel CD allegato alla rivista. 

Marco Poponi 
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Lista variabile di argomenti e altre innovazioni 

Le novità 
di Java 1.5 



parte seconda 



Continuiamo nel nostro approfondimento sulle novità di Tiger, 
affrontando Metadati e Import Statici: non esattamente aspetti 
chiave del linguaggio, ma che possono rivelarsi di grande utilità 



Cominciamo questa nuova puntata con un 
esempio che non potrà lasciarvi indifferenti: 
secondo la nuova sintassi di Java 1.5, la se- 
guente riga di codice: 

public void test(Object ... args) 

dichiara un metodo che può accettare in input un 
numero variabile di parametri (argomenti) di tipo 
Object. Come si può notare, deve essere specificato il 
tipo, tre puntini ed il nome del parametro. Il metodo 
potrà quindi essere invocato passando un numero 
arbitrario di oggetti: 



test(obj); 


test(objl, 


ob:2) 






test(objl, 


obj2, 


obj3) 




test(objl, 


obj2, 


obj3. 


obj4); 



e persino nessun parametro: 



test(); 



All'interno del metodo, gli argomenti passati saran- 
no visti come elementi di un array. Nel seguente 
esempio mostreremo un metodo che accetta in in- 
put una lista variabile di oggetti, ne visualizza la di- 
mensione e, in seguito, ogni singolo elemento: 



public void test(Object ... e 


rg: 


){ 




System, out.println 


("Numero di parametri: 


+ 


args 


length); 


for(Object obj: args) { 


System, out.println(obj), 


} 






} 



Invocando il metodo test e passando la stringa 
"Hello" in input, otterremo l'output di Fig. 1: 



test("hello"); 

In questo secondo esempio, passeremo due stringe, 
una data e un numero. L'output lo trovate in Fig. 2 

test("hello","ciao",new DateQ, 3); 

Resta inteso che è possibile anche invocare testo 
senza alcun parametro: 

test(); 

La lista di parametri potrà appartenere a qualsiasi 
tipo valido. Nel seguente esempio, il metodo rice- 
verà in input una lista di interi: 

public void testlnt(lnteger ... ints) { 
System. out.println 
("Numero di parametri: " + ints. length); 
for(Integer i: ints) {System. out.println(i);} 
} 

Ovviamente in input saranno accettati solo parame- 
tri interi: 

testlntQ; 

testlnt(3); 

testlnt(5,8); 

testInt(27,-9,72); 

Se proviamo ad invocare testlnt passando un tipo 
non intero (per esempio una stringa): 

testInt(5,"otto"); // Errato! 

otterremo un errore in compilazione. 

Un metodo che ha una lista variabile di argomenti, 

può avere in input anche altri parametri; di seguito 




Fig. 1: II primo esperimento 




Fig. 2: Ancora un 
conteggio di parametri 



<n 
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ne portiamo un esempio: 



09^B 

PERCHÉ IMPORT 
"STATIC"? 

Qualcuno si sarà 

certamente chiesto il 

motivo per cui è stata 

introdotta la notazione 

import static e non si è 

utilizzato solamente 

import, visto che 

comunque non 

avrebbe generato 

nessuna ambiguità. 

Le ragioni sono 

fondamentalmente 

due: 



1. Per distinguere a 

colpo d'occhio gli 

import relativi alle 

classi e alle interfacce 

da quelli relativi ai 

membri e ai metodi 

statici. 

2. Per ricordare al 

programmatore che 

solo membri e metodi 

statici possono essere 

importati. (Infatti se si 

cerca di importare un 

membro non statico il 

compilatore segnalerà 

un errore). 

Su questo secondo 
punto sono particolar- 
mente d'accordo, 
poiché utilizzando 
import (senza static) 
per questo nuovo tipo 
di funzionalità avrebbe 
generato molta 
confusione. 



public void test2(String str, 


Integer ... ints) { 


System. out.println("str = 


' + 


str); 






System. out.println 


("Numero dì parametri: 


+ 


ints.l 


Bngth); 




for(Integer i: ints) { System. 


out.println(i); 


}} 



Il primo parametro del metodo test2 è una stringa, il 
secondo è invece una lista variabile di argomenti in- 
teri. Un esempio d'invocazione potrebbe essere il 
seguente: 

testInt2("Hello",6,8); 

In questo caso il primo parametro è obbligatorio; 
non sarà quindi consentito invocare metodo test2 
senza parametri: 

testlnt2(); // Non consentito! 

Quando un metodo presenta argomenti normali e 
una lista variabile di argomenti, questa, al fine di evi- 
tare ambiguità, deve essere sempre specificata come 
ultimo parametro. Detto ciò, la seguente definizione 
non è consentita: 

// Dichiarazione non consentita! 

public void test3(Integer ... ints, String str) { ... } 

Di conseguenza, non è consentito avere metodi con 
più di una lista variabile di argomenti: 

// Dichiarazione non consentita! 

public void test4(Integer ... intsl, Integer ints2) { ... } 

poiché entrambe dovrebbero essere definite come 
ultimo parametro e ciò è impossibile. 



uni ESEMPIO 

L'esempio classico relativo alle funzioni con numero 
variabile di argomenti è il metodo printf che sarà esa- 
minato in un prossimo articolo. Esso riceve in input 
una stringa speciale, detta di formattazione, ed una 
lista variabile di elementi che verranno scritti sullo 
stream di output. Un esempio di invocazione: 

String str = "Ciao"; 

int e = 29; 

System. out. printf 
("%s, sono Mario ed ho %d anni", str, e); 

Un altro contesto dove i metodi a lista variabile d'ar- 
gomenti possono risultare utili è quello relativo alle 
strutture dati classiche. Per esempio, potremmo de- 



finire la primitiva add della struttura dati coda me- 
diante il metodo add che ha in input una lista varia- 
bile d'argomenti: 

public void add(Object ... elements) { ... } 

In questo modo sarà possibile, usando lo stesso me- 
todo, aggiungere anche più di un elemento per volta: 



add("Mario"); 
add("Valentina" 



'Luisa"); 



ANNOTAZIONI 

I metadati sono informazioni aggiuntive che posso- 
no essere associate a classi, interfacce, metodi e sin- 
gole variabili. Per esempio, si potrebbero creare dei 
tool che leggano (e successivamente elaborino) me- 
tadati dal codice sorgente, dal codice compilato op- 
pure a run-time accedendo direttamente alla Virtual 
Machine. Java 1.5 introduce il concetto di annota- 
zione (annotation) per definire metadati. Una anno- 
tazione è un'informazione aggiuntiva che precede la 
definizione di un'entità Java. Ecco un esempio: 

@SpecialMethod public void test() { ... } 

L'annotazione usata in questo esempio è @Special- 
Method. Ma qual è il suo significato? Indica che 
qualche tool avrà bisogno di quest'informazione ag- 
giuntiva alla classe. Per esempio, potremmo crearne 
uno che elenca tutti i metodi annotati da @Special- 
Method. Per quale motivo? Dipende dall'obiettivo 
del tool. Consideriamo quest'altra annotazione: 

@Autore("Mario Rossi") public void test() { ... } 

In base a questa nuova informazione, potremmo 
costruire un tool che individui tutti i metodi annota- 
ti con @Autore e ne visualizzi il nome. I tool, come 
abbiamo accennato, possono operare sul codice 
sorgente, sul codice compilato o a run-time. Parten- 
do da ciò, ed utilizzando l'annotazione @Autore, 
potremmo implementarne tre tipi differenti che: 

1. a partire dal codice sorgente, individui l'autore 
per ogni metodo; 

2. a partire dal bytecode, individui l'autore per ogni 
metodo; 

3. a partire da un'applicazione in esecuzione, indi- 
vidui l'autore per ogni metodo. 

Utilizzare la strategia adatta dipende al contesto in 
cui il tool deve operare. Per esempio, un programma 
che generi automaticamente documentazione a 
partire dalle annotazioni (tipo JavaDoc), adotterà la 
prima strategia. 
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DI UNA ANNOTAZIONE 

Nel paragrafo precedente abbiamo visto come an- 
notare un'entità Java, ma non come e dove sia stata 
definita l'annotazione. L'annotazione @SpecialMe- 
thod può essere definita come una interfaccia spe- 
ciale nel seguente modo: 

©interface SpecialMethod {} 

Questa interfaccia, rappresenta un tipo particolare 
di annotazione denominata marcatore, la sua parti- 
colarità è di non definire né metodi né informazioni 
aggiuntive, per questa sua caratteristica può solo 
marcare l'entità Java che la seguirà. L'annotazione 
@ Autore invece dovrà essere definita come segue: 

©interface Autore {String nome();} 

In questo caso, l'annotazione @ Autore definisce il 
metodo nome. Questo tipo di annotazione è chia- 
mata a membro singolo, poiché definisce un solo 
metodo. Quindi con: 

@Autore("Mario Rossi") ... 

si utilizza l'annotazione @ Autore in cui il metodo 
nome restituisce le stringa "Mario Rossi". I marcato- 
ri e le annotazioni a membro singolo sono un caso 
particolare delle annotazioni dette normali, ovvero 
che contengono più metodi. Ad esempio: 

©interface Info { 
int codice(); 
String autore(); } 

L'annotazione @Info sarà utilizzata nel seguente 
modo: 

@Info(codice=100, autore="Mario Rossi") ... 

Esistono altri tipi più complessi di annotazione (di 
array, complesse, con valori di default, ecc). 



L'ANNOTAZIONE 
©OVERRIDES 

Java 1.5 definisce alcune annotazioni standard. 
Quella più utile è certamente l'annotazione @Over- 
rides. Essa può essere utilizzata per specificare espli- 
citamente che un metodo effettua l'overriding del- 
l'omonimo presente nella classe base. Il compilato- 
re userà l'annotazione per controllare se l'overriding 
è corretto. Supponiamo di avere la classe A: 

class A { 



public void foo() {...}} 

e la classe B che effettua l'overriding del metodo foo, 
ma in modo errato: 



class B extends A { 
public void foo(int n) { 



}} 



Bene, ciò che abbiamo fatto è semplicemente l'over- 
loading del metodo foo e non l'overriding. Il compi- 
latore non segnalerà nessun errore, poiché non 
conosce le nostre intenzioni. Se invece utilizziamo 
l'annotazione @Overrides: 



class B extends A { 


// Errore in compilazione! 


@Overrides public void foo(int n) {. 


■}} 



allora il compilatore segnalerà l'errore e noi ci accor- 
geremo di aver utilizzato una signature diversa. 
La definizione corretta sarà: 

class B extends A { 
@Overrides public void foo() {... } } 

Un tipico esempio di errore di questo tipo è quando 
si vuole ridefinire il metodo equals per una nostra 
classe (per esempio la classe Persona). 
Spesso si è tentati di scrivere: 

public boolean equals(Persona p){...} 

invece di: 

public boolean equals(Object p){...} 

che è la versione corretta. 

Se utilizziamo l'annotazione @Overrides il compila- 
tore ci informerà dell'eventuale errore: 

//Errore in compilazione 

@Overrides public boolean equals(Persona p){...} 

//Definizione corretta 

@Overrides public boolean equals(Object p){...} 



LE ANNOTAZIONI 
A RUNTIME 

Supponiamo di voler creare un tool che legga le an- 
notazioni a run-time. La prima operazione da fare è 
quella di comunicare che un'annotazione può esse- 
re letta a run-time. Questo può essere fatto median- 
te l'annotazione standard @Retention nel seguente 
modo: 

import static 
java.lang.annotation.RetentionPolicy.*; 
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Fig. 3: L'annotazione 
associata alla classe 
Persona 



@Retention(RUNTIME) @interface Info { 

int codice(); 
String autore();} 

Abbiamo quindi definito l'annotazione Info, avente 
i metodi codice e autore, che a sua volta è annotata 
da @Retention(RUNTIME). Siamo in presenza di 
un'annotazione ad un'annotazione. La costante 
RUNTIME, definita nell'enumerazione RetentionPo- 
licy, specifica che le informazioni presenti dell'anno- 
tazione devono essere disponibile a run-time. 
Altri valori possono essere: 

• SOURCE - L'annotazione sarà visibile solo a 
livello di codice sorgente 

• CLASS (default) - L'annotazione sarà visibile so- 
lo a livello di codice compilato 

Nel seguente esempio utilizzeremo l'annotazione 
@Info sia per una classe, sia per un metodo: 

@Info(codice=100, autore="Mario Rossi") 
public class Persona { 

@Info(codice=101, autore="Antonio Bianchi") 
public void test() { ■■■} 
} 

Noterete che la classe Persona è annotata da @Info, 
dove il codice è 100 e l'autore è Mario Rossi. Il meto- 
do test invece è annotato da @Info, dove il codice è 
101 e l'autore è Antonio Bianchi. 
Per accedere all'annotazione @Info, relativa alla 
classe Persona, si può procedere nel seguente modo: 



In questo caso il metodo test ha due annotazioni: 
@Info e @SpecialMethod. Per ottenere a run-time l'e- 
lenco di tutte le annotazioni associate al metodo 
test, si deve procedere nel seguente modo. 



Persona p = new Persona(); 


Annotation a = p.getClassQ 


.getMethod("test") 


.getAnnotations(); 


for (int i=0; io.length 


, i+ + ){ 


System. out.println 


("a["+i+"] = "+a[i]+" 


"); } 



Come si può vedere, il metodo getAnnotations resti- 
tuisce tutte le annotazioni per il metodo test come 
array di oggetti di tipo Annotation, ovvero la classe 
base per ogni annotazione. 



IMPORTARE DATI 
MEMBRO STATICI 

I dati membro statici vengono spesso utilizzati per 
definire delle costanti, che in seguito possono esse- 
re riferite ricorrendo alla notazione: 

NomeClasse. IDENTIFICATORE 

Per esempio, la classe BorderLayout definisce la co- 
stante CENTER. Per utilizzarla è necessario importa- 
re questa classe (o tutto il package che la contiene) e 
riferire la costante mediante la notazione BorderLa- 
yout.CENTER, come si può vedere dal seguente 
esempio: 




Fig. 4: L'annotazione del 
metodo Get 



Persona p = new Persona(); 

Info info = p.getClass().getAnnotation(Info. class); 
System. out.println("Codice = " + info.codice()); 
System. out.println("Autore = " + info.autorefj); 

Il metodo getAnnotation ha in input il tipo dell'an- 
notazione (Info) e restituisce l'istanza dell'annota- 
zione associata alla classe Persona (Fig. 3). 
Analogamente si può operare con l'annotazione as- 
sociata al metodo test: 

Persona p = new Persona(); 

Info info = p.getClass().getMethod("test") 

.getAnnotation(Info. class); 
System. out.println("Codice = " + info.codice()); 
System. out.println("Autore = " + info.autore()); 

In questo caso il nostro output sarà come in Fig. 4. 
Consideriamo quest'altro esempio: 

@SpecialMethod 

@Info(codice=101, autore="Antonio Bianchi") 
public void test() {■■■ } 



import javax. swing.*; 
import java.awt.*; 

JFrame f = new JFrame(); 
f.getContentPane().add( 
new JPanel(), BorderLayout. CENTER); 

Con i nuovi import statici sarà possibile evitare di 
specificare il nome della classe quando si vuole ri- 
ferire un valore statico. Se all'inizio del nostro file ci 
sarà il comando di import. 

import static java.awt. BorderLayout. CENTER; 

allora non sarà più necessario specificare il nome 
della classe, ma solo quello della costante, come 
mostrato dal seguente esempio: 

import javax. swing.*; 

import java.awt.*; 

import static java.awt. BorderLayout. CENTER; 

JFrame f = new JFrame(); 
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f.getContentPane().add(new JPanelQ, CENTER); 



diventeranno: 



Utilizzando la wild-card * sarà possibile importare abs(x) 
tutti i membri statici relativi ad una classe. Conside- sgrt(x) 
riamo a tale proposito il seguente esempio: max(a, b) 



import javax. swing.*; 


import java.awt.*; 


import static java.awt.BorderLayout.*; 




JFrame f = new JFrame(); 


f.getContentPane().add(new 


JPanel(), 


CENTER); 


f.getContentPane().add(new 


JPanel(), 


EAST); 



Avendo utilizzato: 

import static java.awt.BorderLayout.*; 

è stato possibile riferire sia CENTER, sia EAST senza 
specificare il nome della classe BorderLayout. 



IMPORTARE 
METODI STATICI 

Come abbiamo già accennato, l'import statico può 
essere applicato anche ai metodi statici. Il modo di 
operare è pressoché identico a quello visto per i dati 
membro statici. Se la classe test.MiaClasse contiene 
il metodo statico foo, un'applicazione potrà invocar- 
lo semplicemente utilizzando l'import statico in 
questo modo: 

import static test.MiaClasse.*; 

foo(); 

Un contesto dove importare metodi statici sarà 
molto utile è quello relativo alle funzioni matema- 
tiche presenti in java.lang.Math, che sono metodi 
statici. Utilizzando l'import statico possiamo evi- 
tare di specificare la classe Math ad ogni invoca- 
zione. 
Per esempio, la chiamata: 



Sebbene questo modo di operare sia indubbiamen- 
te comodo (ci siamo sbarazzati del nome della clas- 
se), a mio avvio rappresenta un passo indietro dal 
punto di vista della programmazione orientata agli 
oggetti. Infatti, nessuno ci vieta di creare decine di 
metodi statici in una singola classe e di invocarli in 
seguito, nello stesso modo in cui si invocano le fun- 
zioni del C o del Pascal. Ma c'è di peggio: mediantì 
gli import statici, se ci pensate bene, è possibile di 
fatto creare qualcosa di moto simile alle variabili 
globali! 



AMBIGUITÀ 

Al fine di evitare ambiguità, il compilatore di Java 1.5 
non consente di importare staticamente, nello stes- 
so file, due dati membro aventi lo stesso nome, ma 
appartenenti a classi diverse. Supponiamo che la 
classe A e la classe B definiscano entrambe la co- 
stante SEPARATOR: 



package test; 


public class A { 


public final static char SEPARATOR = ' 


,';} 


package test; 


public class B { 


public final static char SEPARATOR = ':'; 


} 



Importiamo ora i membri statici delle due classi: 

import static test. A.*; 
import static test.B.*; 

System. out.println(SEPARATOR); 

Compilando otterremo il seguente errore: 




IMPORT 
STATICI 

Come tutti sappiamo, 
affinché una classe o 
un'interfaccia possa 
essere utilizzata all'in- 
terno di un file, deve 
essere importata attra- 
verso la parola chiave 
import (tale operazio- 
ne non è necessaria se 
la classe o l'interfaccia 
appartengono allo 
stesso package del 
file). Ecco due banalis- 
simi esempi di import: 



import java.util.ArraList; 
import java. io.*; 

Con Java 1.5 è possibi- 
le importare singoli 
membri statici (dati o 
metodi) utilizzando la 
notazione import sta- 
tic. 



doublé r = Math.sqrt(25); 

diventa: 

import static java.lang.Math. 

doublé r = sqrt(25); 

In generale, le chiamate: 

Math.abs(x) 

Math.sqrt(x) 
Math.max(a, b) 



Esempio.java:7: reference to SEPARATOR is ambiguous, 
both variable SEPARATOR in test.A and variable 
SEPARATOR in test.B match System. out.println( 

SEPARATOR); 

Siamo in presenza di un'ambiguità: il compilatore 
non sa quale costante SEPARATOR utilizzare, quella 
presente in A oppure quella presente in B. 
In questi casi sarà necessario ricorrere al nome della 
classe, quindi A. SEPARATOR per indicare la costante 
appartenente alla classe /l e B.SEPARATOR per indi- 
care la costante appartenente alla classe B. 

Giuseppe Naccamto 
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Parsing del Web come fonte di informazioni 

Stock Spy 



parte seconda 



Stock Spy è un'applicazione 100% Java che, connettendosi ad Internet, 
preleva le quotazioni di borsa. In questo secondo appuntamento 
definiremo l'interfaccia dell'applicazione utilizzando Swing 




QCDQ WEB 

StockSpy.zip 
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Il mese scorso abbiamo visto come prelevare da 
Internet, in tempo reale, le quotazioni dei titoli 
relativi alla borsa italiana. La classe Stock- 
Connector che abbiamo implementato effettua una 
connessione ad un provider di dati e, grazie allo 
StockParser, estrae quotazioni ed informazioni rela- 
tive a tutti i titoli del Mibtel. Questo mese vedremo 
come utilizzare StockConnector per realizzare 
un'applicazione, basata su Swing, che visualizza in 
tempo reale le quotazioni dei titoli del Mib30. Prima 
di iniziare spendiamo qualche parola su 
StockConnector. 



L'INTERFACCIA 

StockConnector 

L'implementazione dell'interfaccia StockConnec- 
tor, come abbiamo visto, dipende dal provider dei 
dati. Per ogni provider è necessario un'interfaccia 
diversa. Lo stesso discorso vale per StockParser. 
Come ricorderete, l'implementazione proposta nel- 
l'articolo precedente usa come provider il sito 
Kataweb Finanza. Abbiamo quindi implementato 
KatawebConnector e KatawebParser in modo che si 
adattino alle caratteristiche del sito, ovvero le varie 
URL per prelevare i dati, il metodo Http (GET) e il 
formato html in output. 

Sebbene un'applicazione possa istanziare diretta- 
mente KatawebConnector, ciò non rappresenta una 
buona strategia. Infatti, se il sito scelto come provi- 
der non dovesse più fornire servizio, la nostra ap- 
plicazione diventerebbe inutilizzabile. Un approc- 
cio più intelligente è quello di caricare l'implemen- 
tazione a run-time, utilizzando il metodo Class.for- 
Name, memorizzando il nome della classe in un file 
di proprietà. In questo modo, se il nostro provider 
non dovesse più essere attivo, potremmo imple- 
mentare StockConnector basandoci su un altro pro- 
vider e specificare questa nuova classe nel file di 
proprietà. Dato che l'applicazione carica a run-time 
l'implementazione ed essa rispetta l'interfaccia 
StockConnector, tutto continuerà a funzionare co- 
me prima. Implementiamo adesso una semplice 



applicazione che invochi i metodi di StockConnec- 
tor basandoci sulla strategia appena descritta. Il pri- 
mo passo è quello di creare un file di proprietà 
(stockspy.properties) e specificare il nome dell'imple 
mentazione di StockConnector nella proprietà 
stock.connector.class: 

#stockspy.properties 

stock. connector.class= KatawebConnector 

L'applicazione leggerà quindi il valore di stock.con- 
nector.class e lo utilizzerà per creare un'istanza di 
StockConnector basato sull'implementazione Kata- 
webConnector: 

Properties properties = new Properties( 

System. getProperties()); 
properties. load(new FileInputStream("stockspy.properties")); 
String connectorName = properties. getProperty( 

"stock.connector.class"); 
StockConnector connector = (StockConnector) 

Class. forName(connectorNa me). newlnstance(); 
connector. con nect(properties); 

Se in futuro si dovrà cambiare provider, sarà suffi- 
ciente implementare StockConnector e specificare il 
nome della nuova classe nella proprietà stock.con- 
nector.class. Se, ad esempio, il nuovo provider è Bor- 
sa Italia e il nome della classe BorsaltaliaConnector, 
il file di proprietà diventerà il seguente: 

#stockspy. properties 

stock. connector.class= BorsaltaliaConnector 

Dopo aver istanziato StockConnector mediante il 
metodo Class.forName, sarà possibile utilizzare l'i- 
stanza connector ed invocarne i metodi. Nell'esem- 
pio che segue verranno visualizzate tutte quotazio- 
ne delle azioni che iniziano con la lettera 't ': 

StockQuote q[] = connector.getByLetter('t'); 

for (int i = 0; i < q.length; i++) {System. out.println(q[i]); } 

il cui output potete apprezzare in Fig. 1. 
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AVVIO DA UNA RETE 

coni PROXY 

Eseguendo Stock Spy all'interno di una rete con 
proxy, sarà necessario specificare le proprietà di si- 
stema proxySet, proxyHost e proxyPort. L'imposta- 
zione può essere effettuata specificano l'opzione -D 
della Java Virtual Machine oppure inserendo le pro- 
prietà nel file stockspy.properties, come di seguito: 

proxySet=true 

proxy Host= myproxy.com 

proxyPort=3128 

dove myproxy.com sarà il nome del vostro proxy e 
3128 la porta. La vostra applicazione avrà il compito 
di leggere le proprietà ed assegnarle alle omonime 
proprietà di sistema. In Stock Spy, questo compito 
sarà effettuato nel programma principale dal meto- 
do statico IoadProperties: 



in verde, quelle negative in rosso. Realizzeremo que- 
sta applicazione utilizzando le Swing ed in partico- 
lare la classe JTable per rappresentare le quotazioni 
delle azioni. La tabella verrà successivamente inseri- 
ta in una dialog che l'aggiornerà ogni cinque minuti 
o alla pressione del tasto "Aggiorna". 



LA STOCKTABLE 

Ad esclusione del metodo getStockQuote, che resti- 
tuisce un oggetto di tipo StockQuote, tutti gli altri 
metodi dell'interfaccia StockConnector, tra cui 
getMib30, restituiscono un array di oggetti Stock- 
Quote. La tabella relativa alla nostra applicazione 
potrebbe quindi essere popolata a partire dagli ele- 
menti di un array StockQuote; in questo modo, essa 
potrà essere riutilizzata per visualizzare qualsiasi 
insieme di azioni. Il modello associato alla JTable sa- 
rà il seguente: 




private static Properties loadPropertiesQ throws Exception { 
Properties properties = new Properties( 

System. getPropertiesQ); 

properties. load(new FileInputStream( 

"stockspy.properties")); 
String sProxySet = properties. getProperty("proxySet"); 
if (sProxySet! = null && sProxySet.equalsIgnoreCase( 

"true")) { 

System. getProperties().setProperty("proxySet",sProxySet); 
String sProxyHost = properties. getProperty("proxyHost"); 

if (sProxyHost!= nuli) 

System. getProperties().setProperty( 

"proxy Host",sProxyHost); 
String sProxyPort = properties. getProperty("proxyPort"); 
if (sProxyPort!= nuli) 
System. getProperties().setProperty( 

"proxy Port",sProxy Po rt);} 
return properties; } 

Come si può notare, il metodo legge tutte le pro- 
prietà dal file stockspy.properties e le restituisce. 
Inoltre, imposta le proprietà di sistema relative al 
proxy con gli eventuali valori presenti nel file. 



MIB30 IH! REALTIIVIE 

Adesso che abbiamo tutti gli ingredienti, possiamo 
iniziare a implementare l'applicazione concreta. 
L'idea è quella di creare una dialog che mostri in una 
tabella le quotazioni delle azioni del Mib 30, specifi- 
cando il nome dell'azione, l'ultimo prezzo, la varia- 
zione rispetto al giorno precedente e l'orario dell'ul- 
timo ordine eseguito. L'applicazione aggiornerà 
automaticamente i valori ogni cinque minuti o su 
richiesta dell'utente. Inoltre, per facilitare la visualiz- 
zazione, le variazioni positive saranno visualizzate 



class StockTableModel extends AbstractTableModel { 
private String columns[] = 

{ "Azione", "Quotazione", "Variazione %", "Ora"}; 
private StockQuote quotes[] = new StockQuote[0]; 
public int getColumnCount() {return columns.length;} 
public int getRowCount() { return quotes.length;} 
public Object getValueAt (int row, int column) { 
if (column ==0) 
return quotes[row].name; 

■■■} 

public String getColumnName (int columnlndex) { 

return columns[columnIndex];} 
public void setQuotes(StockQuote quotes[]) 
{ this.quotes = quotes; } 
private String getTime(Calendar date) { 

... }} 

I dati sono rappresentati dall'array quotes, che all'i- 
nizio sarà vuoto, ma che potrà essere successiva- 
mente reimpostato dal metodo setQuotes. La tabella 
avrà quattro colonne: "Azione", "Quotazione", "Va- 
riazione" e "Ora". Il metodo getValue- 
At, richiamato dal framework per la 
JTable, restituirà il campo opportuno 
della classe StockQuote in base al nu- 
mero di colonna in input. La data rela- 
tiva al campo StockQuote. date verrà 
formattata dal metodo privato getTi- 
me e visualizzata nella tabella nel for- 
matto hh:mm. L'istanza di JTable che 
utilizza questo modello verrà inserita 
in un JPanel denominato StockTable. 
L'implementazione la trovate nel CD 
allegato. Il pannello contiene la JTable 
riferita da table che viene creata utiliz- 
zando il modello StockTableModel im- 
plementato in precedenza. La tabella Fig. 1: L'output di Connector 



T.I.M. 4.64 -0.53% 22/6/2004 12:50 

T.I.M. RNC 4.49 -0.04% 22/6/2004 12:48 

TARGETTI SANKEY 3.42 0.0% 22/6/2004 9:20 

TAS 16.5 0.01% 22/6/2004 12:13 

TC SISTEMA 0.0 0.0% 22/6/2004 0:00 

TDIAAW DIR 16.7.02 0.0 0.0% 22/6/2004 0:00 

TECNODIFFUSIONE ITA 0.0 0.0% 22/6/2004 0:00 

TELECOM IT MEDI RNC 0.0 0.0% 22/6/2004 0:00 

TELECOM ITAL MEDIA 0.342 0.0% 22/6/2004 12:49 

TELECOM ITALIA 2.585 - 0.07% 22/6/2004 12:50 

TELECOM ITALIA RNC 1.855 0.16% 22/6/2004 12:49 

TENARIS 2.7 -1.27% 22/6/2004 12:41 

TISCALI 3.6 -0.22% 22/6/2004 12:50 

TOD'S 27.79 -0.1% 22/6/2004 12:40 

TREVI FINANZ INDUST 1.05 1.84% 22/6/2004 12:28 

TREVISAN COMETAL 3.53 -0.53% 22/6/2004 11:17 

TXT E-SOLUTIONS 19.17 0.0% 22/6/2004 12:25 
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Azione 


Quotazione 


Variazione % 


Ora 


ALLEANZA ASS 


9.38 


35 


16:33 


AUTOSTRADE 


16.31 


0.67 


16:33 


3ANCAANT0NVENETA. 


16.89 


1.62 


16:33 


BANCA FIDEURAM 


4.66 


1.26 


16:33 


BANCHE POP UNITE 


13.59 


1 02 


16:33 


BCA INTESA 


3.19 


1,59 


16:32 


SCO POPÒ VRENO 


14.0 


0.64 


16:33 


BNL 


1 925 


2,01 


16:33 


CAPITALIA 


2.58 


1,93 


16:32 


EDISON 


1.453 


-0,61 


16:32 


ENEL 


66 


-001 


16:33 


ENI 


16.73 


-112 


16:33 


FIAT 


6.9 


2,22 


16:33 


FINMECCANICA 


0.64 


2,23 


16:33 


GENERALI ASS 


22.27 


17 


16:33 


LUXOTTICA GROUP 


13.34 


056 


16:33 


MEDIASET 


9.48 


0.35 


16:33 


MEDIOBANCA 


10.1 


1.39 


16:33 


MEDIOLANUM 


527 


1 65 


16:33 


MONTE PASCHI SIENA 


2.66 


0.56 


16:32 


PIRELLI ÉC. 


0,871 


2,67 


16:33 


RAS 


14.89 


0.48 


16:31 


SAIPEM 


7.75 


-0,42 


16:32 


SAN PAOLO IMI 


9.98 


1.01 


16:33 


SEAT PAGINE GIALLE 


0.35 


2,18 


16:33 


SNAM RETE GAS 


3.56 


-008 


16:32 


STMICROELECTRONICS 


17.83 


1 27 


16:33 


T.I.M. 


4.69 


0,47 


16:33 


TELECOM ITALIA 


2585 


062 


16:33 


UNICREDITO ITALIANO 


4.03 


01 


16:33 




| Aggiorna 



Fig. 2: Mib30Dialog in azione 



verrà posta sul pannello all'interno di un 
JScrollPane. Il metodo reload ha compito di ri- 
popolare la tabella con i dati passati nell'array in in- 
put. Esso richiama il metodo setQuotes del modello 
ed effettua un aggiornamento della tabella. Questo 
metodo verrà invocato ogni qualvolta le quotazioni 
verranno prelevate dal provider. Come si può nota- 
re, il costruttore di StockPanel richiama il metodo 
setDefaultRenderer per la JTable passando un'istan- 
za di ColoredTableCellRenderer. Questa classe, im- 
plementata da noi, ha il compito di visualizzare in 
verde le variazioni di prezzo positive e in rosso quel- 
le negative. L'implementazione di ColoredTable- 
CellRenderer la trovate sul CD. 



LA DIALOG MIB30 

Il pannello StockTable è del tutto generico e funzio- 
na a partire da un qualsiasi 
array di StockQuote. Vedremo 
in questo paragrafo come re- 
alizzare una dialog che utiliz- 
zando StockTable visualizzi in 
tempo reale le quotazioni 
delle azioni relative al Mib30. 
La classe si chiama Mib30- 
Dialog e conterrà la StockTa- 
ble ed un bottone "Aggiorna" 
che consentirà all'utente di 
aggiornarla. Inoltre, la dialog 
si aggiornerà automatica- 
mente ogni cinque minuti. Il 
costruttore della classe avrà il 
compito di leggere le proprie- 
tà, impostare l'interfaccia 
grafica, prelevare le quotazio- 
ni da Internet e mostrarle: 



private void showQuote() { 

try { 

connector.connect(properties); 
StockTable. reload(connector.getMib30()); 
} catch(Exception ex) { 
ex.printStackTrace(); }} 

Sempre nel costruttore avverrà l'impostazione del- 
VActionListenerper il bottone "Aggiorna": 

btnUpdate.addActionListener(new ActionListener() { 
public void actionPerformed(ActionEvent e) { 
Mib30Dialog,this,showQuote();} 

}); 

e la definizione del thread che ogni cinque minuti 
aggiorna la tabella. 

Thread t = new Thread(new Runnable() { 
public void run() { 

for(;;) { 

try { 

// Cinque Minuti 

Thread.sleep(5 * 60 * 1000); 

} catch(Exception ex) {ex.printStackTrace();} 

Mib30Dialog.this.showQuote();} } }); 

t.start(); 

Il metodo main sarà quindi il seguente: 

public static void main(String a[]) throws Exception { 

Mib30Dialog dialog = new Mib30Dialog(); 

dialog. setVisible(true); } 

Lanciando l'applicazione, mediante la seguente li- 
nea di comando: 

> java Mib30Dialog 
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public Mib30Dialog() throws Exception { 
super("Stock Spy"); 
properties = loadProperties(); 
connector=(StockConnector) Class. forName(properties 
.getProperty("stock.connector.class")).newInstance(); 

setSize(500,560); 

StockTable = new StockTable(); 
getContentPane().setLayout(new BorderLayoutQ); 
getContentPane().add(stockTable, BorderLayout.CENTER); 
JPanel pnIBottom = new JPanel(new BorderLayout()); 
getContentPane().add(pnlBottom, BorderLayout. SOUTH); 
JButton btnUpdate = new JButton("Aggiorna"); 
pnIBottom. add(btnUpdate, BorderLayout. EAST); 
showQuote(); 



Il metodo showQuote invocherà il metodo getMib30 
dello StockConnector e passerà le quotazione alla 
StockTable utilizzando il metodo reload: 



verrà visualizzata la dialog di Fig. 2, contenente le 
azioni del Mib30 e le relative quotazioni. 



CONCLUSIONI 

L'applicazione appena vista è giusto un esempio che 
mostra le potenzialità del nostro StockConnector. 
Essa funziona solo con le azioni del Mib30, ma con 
facili modifiche potrete far in modo che funzioni con 
tutte le azioni del listino. Infatti, è sufficiente in- 
vocare getQuoteAll, getByhetter oppure getCustom al 
posto di getMib30 e la tabella visualizzerà i dati op- 
portuni. Il prossimo mese aggiungeremo un ultimo 
tassello all'applicazione Stock Spy, ovvero la possibi- 
lità di memorizzare i dati all'interno di un database 
relazionale in modo da ottenere lo storico delle quo- 
tazioni per eventuali statistiche ed analisi tecnica. 

Giuseppe Naccarato 
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Un Web Service per gestire un torneo di Fantacalcio 

Web Service 



e Fantacalcio 



parte terza 



Migriamo la nostra applicazione di Fantacalcio verso 
un'architettura a servizi: progettiamo un Web Service per 
la consultazione del torneo 



Siamo ormai giunti alla terza puntata del per- 
corso dedicato allo sviluppo di una soluzione 
per la gestione di un torneo di Fantacalcio. Ri- 
cordiamo che nei precedenti abbiamo seguito pas- 
so dopo passo tutte le fasi della progettazione di 
una classica applicazione per la gestione di un tor- 
neo: siamo partiti, infatti, definendo un modello di 
classi di business ed una base dati relazionale ed 
abbiamo illustrato la loro definizione mediante l'u- 
tilizzo del tool ObjectRelatìonalBridge (OJB) e del 
database HSqlDb. Successivamente abbiamo realiz- 
zato un'applicazione grafica di gestione del Fanta- 
calcio (dedicata soprattutto all'amministratore del 
torneo) ed abbiamo implementato alcune princi- 
pali funzionalità del motore interno. Scopo di que- 
sta puntata è quello di realizzare, mediante l'archi- 
tettura dei Web Services, dei servizi che permettano 
anche ad altri utenti di poter consultare i dati relati- 
vi ad un torneo di Fantacalcio. Logicamente, que- 
sta è un'occasione per esaminare da vicino un reale 
utilizzo dei Web Services in un contesto già familia- 
re dato che possiamo sfruttare quanto realizzato fi- 
nora. 



QUALCHE 
CONCETTO DI BASE 

In questa sede non è opportuno approfondire il di- 
scorso sulle origini e sui concetti fondamentali che 
sono alla base dei Web Services; pertanto daremo 
solo qualche definizione generale. Innanzitutto, 
stabiliamo che per servizio s'intende un'applicazio- 
ne che espone le sue funzionalità ad un'altra appli- 
cazione mediante un'interfaccia di programmazio- 
ne (API). In altri termini non si tratta d'altro che di 
una risorsa utilizzabile da un'altra applicazione e 
non da un utente umano. Tale concetto di servizio è 
insito nel design dell'applicazione cui ci si riferisce 



con il nome di SOA. Per far sì che un client possa ac- 
cedere ad un servizio disponibile in Rete, occorre 
definire necessariamente delle apposite interfacce 
di programmazione. Si può utilizzare uno dei midd- 
leware di comunicazione realizzati finora (RPC, 
DCOM, CORBA, RMI) ma questi ultimi, a differenza 
dei Web Services, soffrono di alcuni problemi di 
scarsa omogeneità, integrazione e flessibilità. Di se- 
guito riportiamo le principali caratteristiche dei 
Web Services che ci permettono di capire meglio le 
loro potenzialità: 

• un WS è una risorsa del Web, accessibile me- 
diante un protocollo indi- 
pendente e neutrale quale 
HTTP 

• un WS espone un'interfaccia 
(Web API) utilizzabile da 
qualsiasi altra applicazione 

• un WS è registrato in un op- 
portuno Web Registry. 
Quest'ultimo permette ai 
client di localizzare i servizi 
richiesti 

• i WS offrono un forte disac- 
coppiamento tra le applicazioni in quanto la 
comunicazione avviene mediante lo scambio di 
messaggi XML. 

Parlando di Web Services ci s'imbatte necessaria- 
mente in una serie di acronimi che possono genera- 
re un po' di confusione. Il primo di loro è WSDL 
(Web Services Description Language), una gramma- 
tica XML che permette di definire l'interfaccia del 
servizio esposto. Un altro è la specifica UDDI (Uni- 
versal Discover Description and Integration) che 
permette ad un qualsiasi client di localizzare sulla 
Rete il servizio richiesto in modo da poterlo utiliz- 
zare. L'ultimo acronimo è il SOAP (Simple ObjectAc- 
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Fig. 1: Un Service Provider ospita un gruppo 
di Web Services, mentre un Service Reposito- 
ry pubblica delle informazioni che permettono 
ai client di localizzare il servizio richiesto 



in 




REQUISITI 



M4M.Wi.UM 



— Java, UML, 
-' Programmazione 
ad oggetti 



OJB, J2SE, HSqlDb, 
XML, Java Web 
Services Developer 
Pack 



Tempo di realizzazione 



00 



http://www.ioprogrammo.it 



Novembre 2004/ 55 ► 



TEORIA & TECNICA 



Giochiamo a "calcio" con gli oggetti 



fflR 


P!P 




V J2SE ip 







cess Protocol): esso, definendo la modalità di acces- 
so ad un Web Service. In particolare si tratta di un 
protocollo che permette di incapsulare, all'interno 
della richiesta, un messaggio XML, utilizzando un 
protocollo di comunicazione standard quale 
l'HTTR 



• prossima giornata da giocare 

• classifica del campionato 

Il punto di partenza per la creazione di tale servizio 
è la definizione di un'interfaccia Java (denominata 
in gergo service endpoint interface) che estenda ja- 
va.rmi.Remote e che definisca i metodi esposti. 




GLOSSARIO 



RMI 

È un modello di 

architettura distribuita 

che permette ad un 

client Java di 

effettuare chiamate a 

metodi di oggetti 

remoti Java come se 

questi fossero locali. 

Il modello si basa su 

due opportune classi 

generate 

automaticamente 

dette stub e skeleton e 

che implementano il 

colloquio tra client e 

server. 



JAVA WEB SERVICES 
E JAX 

Mediante Java Web Services, lo sviluppatore Java 
può costruire delle applicazioni server implemen- 
tanti le caratteristiche dei Web Services propria- 
mente detti. La Sun mette a disposizione un pac- 
chetto, denominato JWSDP {Java Web Services De- 
veloper Pack), che consiste principalmente di una 
serie di API, tra cui le più importanti sono quelle 
relative al JAX (Java API per XML), in aggiunta ad al- 
cuni tool quali Jakarta Tomcat Web Container, Ant 
ed un UDDI-based regstry server. Le API per XML so- 
no distinte in quattro componenti principali: 

• JAXP e JAXB: si occupano del processing e del 
bindingXML. 

• JAXM: relative al messaging. 

• Registries: per i registri XML. 

• JAX-RPC: per le chiamate RPC basate su XML. 



JAX-RPC Java Client 



JAX-RPC Web Seivice 



: ::...:.:::.. ;SO.< ; 




protocollo (SOAP) 



Chiamate RPC via SOAP 



Fig. 2: Rispetto al predecessore, JAX-RPC può 
essere utilizzato per accedere a Web Services 
non Java. 




GLOSSARIO 



SOA 

L'acronimo sta per 
Service Oriented Archi- 
tecture e definisce 
un'architettura di base 
utilizzata nella mag- 
gior parte dei sistemi 
di middleware basati 
su RPC (Remote 
Procedure Cali). La 
caratteristica più 
importante del SOA è 
la separazione 
dell'interfaccia del 
servizio dalla sua 
implementazione. 



L'ultima componente è quella 
che più ci interessa: altro non è 
che una specifica per effettua- 
re chiamate a metodi remoti 
mediante XML e SOAP su pro- 
tocollo HTTP In effetti, JAX- 
RPC è una versione rinnovata 
del predecessore RMI (Remote 
Method Invocation) che per- 
mette ad un client Java di ac- 
cedere ad un Web Service co- 
me se fosse locale. In sintesi, JAX-RPC è in grado di 
generare WSDL a partire da un'interfaccia Java (e 
viceversa), nonché ovviamente di produrre le classi 
di stub e skeleton. 



IL FANTACALCIO 
SERVICE 

A questo punto, procediamo con la progettazione 
del nostro Web Service mediante il JAX-RPC (nel 
corso dell'articolo si è utilizzata la versione 1.3 del 
JWSDP). Scopo del servizio è di permettere ai diver- 
si partecipanti al torneo di consultare diverse infor- 
mazioni utili quali ad esempio: 

• squadre partecipanti e rosa dei calciatori 

• calendario della stagione in corso 



public interface FCalcioIF extends Remote { 
String[] getSquadre() throws 

RemoteException,BusinessException; 
String getStagioneAttuale() throws 

RemoteException,BusinessException; 
GiornataBean[] getCalendario(String stagione) 

throws RemoteException,BusinessException; 
GiornataBean getProssimaGiornata(String stagione) 
throws RemoteException,BusinessException; 
CalciatoreBean[] getRosaSquadra(String nome) 

throws RemoteException,BusinessException; 
PuntiSquadraBean[] getClassifica(String stagione) 

throws RemoteException,BusinessException; } 

Possiamo notare innanzitutto che valgono le mede- 
sime regole stabilite per l'RMI: ogni metodo è in 
grado di scatenare (in aggiunta alla BusinessExcep- 
tion definita dal nostro modello) un'eccezione di ti- 
po java.rmi.RemoteException. Ciò accade proprio 
perché, come detto, il JAX-RPC è un'estensione di 
RMI. Nonostante siamo partiti da una classica in- 
terfaccia Java, sappiamo che l'interfaccia di un Web 
Service è definita mediante una particolare gram- 
matica XML denominata WSDL (in realtà si potreb- 
be anche iniziare, nella creazione di un WS, diretta- 
mente da un file WSDL). Dietro le quinte, infatti, 
JAX-RPC mappa i tipi di dato Java in definizioni 
WSDL. Mentre i tipi primitivi (int, long, boolean, 
ecc.), le classi fondamentali {String, Integer, Date, 
ecc.) e gli array sono completamente supportati, 
per i tipi più complessi è necessario attenersi ad al- 
cune regole. Senza entrare troppo in dettaglio, di- 
ciamo che in tali casi il JAX-RPC permette l'utilizzo 
di classi personalizzate aderenti allo standard Java- 
Beans, dotate quindi di metodi set e get per ogni at- 
tributo private ed in cui ogni attributo stesso è a sua 
volta un tipo supportato. Per tale motivo, il tipo di 
ritorno di alcuni metodi dell'interfaccia FCalcioIF è 
costituito da classi Bean: si tratta di semplici classi 
JavaBeans, definite nel package /calcio, bean, che 
contengono un gruppo di informazioni correlate tra 
loro. Il prossimo passo da compiere è quello di defi- 
nire un'implementazione per la nostra interfaccia. 
A tal fine è sufficiente definire una classe FCalcioIm- 
pl ed in essa implementare i metodi dell'interfaccia 
FCalcioIF Nel nostro caso, possiamo efficacemente 
utilizzare quanto realizzato nel corso dei preceden- 
ti articoli lavorando sul motore dell'applicazione. 
Come visibile nel class diagram riportato in Fig. 5, le 
funzionalità sono già messe a disposizione dall'in- 



► 56 /Novembre 2004 



http://www.ioprogrammo.it 



Giochiamo a "calcio" con gli oggetti 



T TEORIA & TECNICA 



terfaccia FCModel. La classe FCalcioImpl deve quin- 
di semplicemente creare un oggetto di FC Model e 
utilizzarne i relativi metodi. 

public class FCalcioImpl implements FcalcioIF { 
private FCModel model; 
public FCalcioImplQ { 

try { 

model = new FCModelImplQ; 
} catch(ODMGException oe) 

{ logger.error(oe.getMessage(),oe);} } 

L'implementazione del metodo getSquadre, ad 
esempio, delega semplicemente il compito al moto- 
re stesso. 

public String[] getSquadreQ throws BusinessException 
{ logger.info("called getSquadre..."); 
return model. getSquadre(); } 

Viceversa, nel caso di getCalendario, l'implementa- 
zione deve creare opportune istanze della classe 
GiomataBean a partire dal risultato ottenuto (un 
oggetto Campionato) dalla funzionalità base del 
motore. 



reBean. Resta infine il metodo getClassifica. Esso de- 
ve implementare una logica più complessa consi- 
stente nel leggere il calendario (a partire dall'ogget- 
to di business Campionato) ed a comporre una clas- 
sifica di oggetti PuntiSquadraBean, rappresentanti 
la posizione di ogni singola squadra. In questo caso, 
come possiamo vedere, il metodo utilizza una clas- 
se di utilità, denominata ClassificaComposer. 

public PuntiSquadraBean[] getClassifica(String 

stagione) throws BusinessException { 

logger.info("called getClassifica for stagione " + stagione); 

String squadre[] = model. getSquadreQ; 

ClassificaComposer composer = new 
ClassificaComposer(squadre); 

Campionato e = model. getCampionato(stagione); 

List giornate = c.getGiornateQ; 

composer. run(giornate); 

List ci = composer.getClassifica(); 

PuntiSquadraBean[] psb = new 

PuntiSquadraBean [ci. size()]; 

for(int k=0;k<cl.size();k++) 

psb[k] = (PuntiSquadraBean) cl.get(k); 

return psb;} 





GLOSSARIO 



OBJECTRELATIO 
IUALBRIDGE 

È un tool di mapping 
della Apache Software 
Foundation per la 
persistenza di oggetti 
Java verso un base dati 
relazionale. Il tool, 
open source, offre le 
interfacce ODMG e JDO 
è disponibile 
all'indirizzo 
http://db.apache.org/ . 



public GiornataBean[] getCalendario(Strìng stagione) 
throws BusinessException { 
logger.info("called getCalendario for stagione " 

+ stagione); 
Campionato e = model. getCampionato(stagione); 
List giornate = c.getGiornate(); 
GiomataBean clb[] = new GiornataBean[giornate.size()]; 
for(int k=0;k<giornate.size();k++) { 
Giornata g = (Giornata) giornate. get(k); 
clb[k] = createGiornataBean(g); } 
return db; } 

Analogamente avviene per i metodi getProssima- 
Giornata e getRosaSquadra che traducono gli ogget- 
ti di business [Giornata e Squadra) ottenuti dal mo- 
tore in istanze delle classi GiomataBean e Calciato- 
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Fig. 3: Le classi JavaBeans non sono necessaria- 
mente una copia fedele di quelle di business in quan- 
to ne rappresentano solo una particolare vista 



PACKAGING 
E DEPLOYIHIG 

A questo punto, il codice Java per il Web 
Service è completo. Restano da fare pe- 
rò una serie di operazioni per termina- 
re la fase di packaging ed installazione 
del nostro servizio. In tale fase entra in 
gioco Ant (nella directory è presente il 
file build.xml necessario ad effettuare il 
build dell'applicazione) e dovremmo 
semplicemente creare e/o configurare 
solo una serie di file. Una volta installa- 
to il JWSDR la prima operazione da fare 
consiste nel modificare, all'interno del 
file build.properties, le proprietà che indicano il 
path dell'installazione. 

jwsdphome=C:/java/jwsdp-1.3 
jwsdpshared=${jwsdphome}/jwsdp-shared 

In questo modo, Ant sarà in grado di effettuare auto- 
maticamente il deploy del servizio. Il prossimo pas- 
so da compiere è quello di modificare alcuni file di 
configurazione del motore dell'applicazione, posti 
nella directory etclconf, e relativi a Log4j ed ad OJB. 
In particolare, nel file logéj.properties, contenente la 
configurazione del logging per nostro servizio, va 
specificato il path dei file di log, impostando, ad 
esempio, la directory d'installazione del JWSDR 

log4j. appender. Root=org.apache.log4j.RollingFileAppender 
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Fig. 4: La definizione di un'interfaccia 
e di una sua implementazione costitu- 
iscono la base di partenza di un Web 
Service 
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log4j. appender. Root.File=C:/java/jwsdp-1.3/logs/root. log 

Gli altri file di configurazione, presenti sempre nella 
stessa directory etclconf, sono relativi a OJB e con- 
tengono le informazioni necessarie al mapping ed 
alla connessione al database. Il solo file da modifi- 
care è repository_database.xml in cui va impostato il 
patii relativo alla cartella contenente il database 
HSqlDb utilizzato. 
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F/g. 5: // motore dell'applicazione, sviluppato nei precedenti articoli, è basato sul- 
l'interfaccia FCModel e sulla relativa implementazione FCModellmpI 



SUL WEB 



Possiamo impostare, come indicato sotto, la direc- 
tory di lavoro di JWSDP 




Java Web Services 
Tutorial 

http://ja va .su n .com/ 
webservices/tutorial.html 

JAX-RPC Home 

http://lava.sun.com/xml/ 
jaxrpc/index.html 

Web Services 
Description Language 
(WSDL) 1.1 W3C Note 

www.w3.orq/TIVwsdl 





Fig. 6: All'interno del JWSDP è presente un'istanza di 
Torneai quale Web Container 



poiché il processo di build di Ant vi copierà un data- 
base di prova contenuto nella directory etcldata. Pri- 
ma di procedere con il deploy dell'applicazione esa- 
miniamo brevemente i passi che saranno eseguiti 
all'interno del build di Ant. Poiché un JAX-RPC Web 
Service in realtà altro non è che un servlet, esso può 
essere impacchettato ed installato mediante un file 
WAR. Pertanto, dopo aver compilato i file sorgenti 
presenti all'interno della directory srclsewer, il build 
di Ant ha anche il compito di creare un normale file 
WAR al cui interno vanno tra l'altro inserite le libre- 
rie ed i file di configurazione (quelli appena visti 
relativi a Log4j ed ad 
OJB) necessari al motore 
dell'applicazione. 
Un normale file WAR 
non è però ancora in 
grado di definire un Web 
Service, in quanto non 
sono presentì la defini- 
zione WSDL dell'inter- 



faccia, gli stub, gli skeleton, ecc. Il JAX-RPC mette a 
disposizione due tool, wscompile e wsdeploy, che 
sono in grado di generare queste risorse aggiuntive. 
Il primo tool, wscompile, è in grado di generare i file 
di mapping (WSDL, stub, skeleton, ecc.) sia per 
client che per il server. Tale tool, leggendo in input 
un file configurazione in XML, è anche in grado di 
generare un'interfaccia Java a partire da un file. Ad 
esempio, definendo, per il nostro WS, un file con- 
fig.xml (presente nella directory etc) come: 

<?xml version="1.0" encoding = "UTF-8"?> 
<configuration xmlns="http: 

//java.sun.com/xml/ns/jax-rpc/ri/config"> 
<service name="FCalcio" targetNamespace 

= "http://fcalcio.org/wsdl" 
typeNamespace="http://fcalcio.org/types"packageName 

="fcalcio.service"> 
< interface name="fcalcio.service.FCalcioIF" 
servantName="fcalcio.service.FCalcioImpl"/> 

</service> 
</configuration> 

comunichiamo a wscompileìe seguenti informazio- 
ni utili a generare i file di mapping necessari al WS: 

• il nome del servizio 

• il namespace WSDL 

• il package contenente le classi del servizio 

• il service endpoint interface 

L'altro tool, denominato wsdeploy, legge un norma- 
le file WAR e, interpretando un file di configurazione 
(comunemente denominato jaxrpc-ri.xml e posto 
all'interno del WAR di input), genera un altro WAR 
pronto per il deploy. In realtà, dietro le quinte, esso 
utilizza il comando wscompile al fine di generare le 
classi ed il file WSDL da includere poi all'interno del 
nuovo WAR. Nel nostro caso, il file WAR, creato in 
precedenza, è quindi processato direttamente dal 
tool wsdeploy, il quale leggerà il nostro file jaxrpc- 
ri.xml (definito nella solita directory etc) ed incluso 
all'interno del WAR iniziale. 

<webServices 

xml ns=" http://java.sun.com/xml/ns/jax-rpc/ri/dd" 

version = "1.0" 
targetNamespaceBase= "http://fcalcio.org/wsdl" 

typel\lamespaceBase= "http://fcalcio.org/types" 
urlPatternBase="/fcalcio"> 
<endpoint name="FCalcio" displayName= 

"Fantacalcio Service" description = "A fantacalcio 

web service" wsdl = "/WEB-INF/FCalcìo.wsdl" 

interface="fcalcio.service.FCalcioIF" 

implementation ="fcalcio. service. FCalcioImpl"/> 

<endpointMapping endpointl\lame="FCalcio" 

urlPattern = "/fcalcio"/> 
</webServices> 
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Come si può notare, sono presenti più o meno le 
stesse informazioni contenute nel config.xml defi- 
nito nel caso si volesse utilizzare comando wscom- 
pile. A questo punto possiamo effettuare il build e 
l'installazione del nostro WS (il file WAR prodotto 
verrà copiato nella diretory webapps del JWSDP) di- 
gitando semplicemente 

ant deploy-war 

Se non lo abbiamo già fatto, occorre lanciare il ser- 
ver (vedi Fig. 6) e, richiedendo al browser l'indirizzo 
http:lllocalhost:8080ljaxrpc-FantaCalciolfcal- 
cio?WSDL, potremo visualizzare il file WSDL del ser- 
vizio. 



UHI CLIENT 

PER IL WEB SERVICE 

Finalmente è giunto il momento di creare un client 
in grado di accedere alle funzionalità offerte dal 
nostro servizio. Il modo più semplice di creare un 
client per un WS è di legarlo staticamente alla servi- 
ce endpoint interface mediante uno stub statico: si 
tratta di un oggetto proxy che definisce tutti i meto- 
di offerti dalla service endpoint interface. Vi sono 
anche altre modalità di invocazione dinamica, che 
permettono invece un maggiore disaccoppiamen- 
to tra client e service endpoint interface. Nel nostro 
caso, il client sarà una semplice applicazione di te- 
sto che utilizza uno stub generato a tempo di com- 
pilazione mediante il tool wscompile. Prima di svi- 
luppare il client Java, occorre infatti impostare un 
file di configurazione (un esempio è il file conflg- 
wsdl.xml contenuto in etc) in cui è specificata 
l'URL del file WSDL ed il package del servizio. 

<?xml version = "1.0" encoding="UTF-8"?> 
<configuration 

xmlns="http://java.sun.com/xml/ns/jax-rpc/ri/config"> 
<wsdl location = "http://localhost:8080/ 

jaxrpc-FantaCalcio/fcalcio?WSDL" 
packageName="fcalcio. service" /> 
</configuration> 

Il tool wscompile, leggendo quanto descritto nel file 
WSDL ritornato all'URL indicato, crea lo stub e tutto 
l'occorrente, (quale classi di serializzazione e tipi di 
dati), per la compilazione del client. 
A questo punto possiamo utilizzare, nella classe 
FCalcioClient, lo stub generato facendone il cast 
all'interfaccia FCalcioIF ed invocandone i metodi 
richiesti. 

public class FCalcioClient { 

private static Stub createProxy() { 
return (Stub) (new FCalcio_Impl( 



).getFCalcioIFPort()); 

} 

public static void main(String[] args) { 
try { 

Stub stub = createProxy(); 

stub. _setProperty(javax. xml. rpc. Stub 

.ENDPOII\IT_ADDRESS_PROPERTY, 
"http://localhost:8080/jaxrpc-FantaCalcio/fcalcio"); 
FCalcioIF fcalcio = (FCalcioIF) stub; 
System. out.println("Web Service Fantacalcio"); 
String stagione = fcalcio. getStagioneAttuale(); 
System. out.println("Stagione attuale: " + stagione); 



Digitando il comando 





ant compile-client 

otterremo, come descritto, la generazione dello stub 
e la compilazione del client. Fatto ciò siamo quindi 
in grado di eseguire l'applicazione client digitando 

ant run-client 



CONCLUSIONI 

Abbiamo così realizzato, mediante JAX-RPC, un 
Web Service del Fantacalcio sfruttando quanto 
messo a disposizione già dal motore interno della 
nostra applicazione. 
Per sempli- 
cità l'imple- 
mentazione 
del servizio 
utilizza e ge- 
stisce in pro- 
prio una 
connessione 
al database 
ma, ovvia- 
mente, sa- 
rebbe molto 
più efficiente 
ottenere tale 
connessione 
da un pool 
gestito dal 
Web Contai- 
ner (in que- 
sto caso Tomcat). Nel corso dell'articolo abbiamo 
inoltre implementato un client statico facilmente e 
velocemente realizzabile ma che, come rovescio 
della medaglia, risulta strettamente legato al servi- 
zio. Una possibile direzione di sviluppo potrebbe 
essere quindi quella di utilizzare una strategia di 
invocazione dinamica. 
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aual Stagione attuale: 2003-04 








aua] Squadra 1: Forti fc Tenaci 








aua] — Rosa — 

aua] flBBimi Christian (portiere) 
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Fig. 7: Nella finestra dei comandi vengono visualizzate tutte le 
informazioni ottenute interrogando il servizio 
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I trucchi del mestiere 

Tips & TVicks 

Questa rubrica raccoglie trucchi e piccoli pezzi di codice, frutto dell'esperienza di chi programma, che solitamente non 
trovano posto nei manuali. Alcuni di essi sono proposti dalla redazione, altri provengono da una ricerca su Internet, altri 
ancora ci giungono dai lettori. Chi volesse contribuire, potrà inviare i suoi Tips&Tricks preferiti. Una volta selezionati, 
saranno pubblicati nella rubrica. Il codice completo dei tips è presente nel CD allegato nella directory \tips\o sul Web 
all'indirizzo: cdrom.ioprogrammo.it. 




VISUAL 
BASIC 



CHIUDERE UM FORM 
QUANDO PERDE IL FOCUS 

(Nel CD: \codice\ CloseForm.zip) 

Queste funzioni servono principalmente per gestire un 
forni utilizzandolo come una finestra di pop-up (tipo la 
lista a discesa da un combobox). Gli eventi Deattivate e 
LostFocus non possono essere utilizzati correttamente 
quando si utilizzano forni MDI e modali. Si deve aggiun- 
gere al progetto un modulo con le chiamate API necessa- 



rie e poi richiamare le funzioni in quattro eventi del forni 
in questione (Form_Load, FormJJnload, Form_MouseDown, 
Form_MouseUp). Di seguito, per comodità, riportiamo il 
solo modulo; sul CD-Rom allegato alla rivista e/o sul web 
(www.ioprogrammo.it) potrete reperire l'applicazione com- 
pleta in formato sorgente \codice\ CloseForm.zip 

Tip fornito dal sig. R. Roncato 



Option Explicit 


'Per gestire il focus 


Private Const GWL_WNDPROC As Long = 


-4 


Private Const WM_NCACTIVATE As Long = 


= &H86 


Private Const NO_ACTIVE As Long = 



1) IL TIP DEL MESE 

DA OUTLOOK 
A VISUAL BASIC 

Un tip per prelevare tutti i contatti presenti in Microsoft 

Outlook 2003 e trasferirli in un'applicazione Visual 

Basic. 

Nel caso in cui si stia sviluppando un'applicazione di 

tipo manageriale, mantenere aggiornati i contatti tra la 

nostra applicazione e Microsoft Outlook sarebbe molto 

positivo! 

Tip fornito dal sig. D.Stopponi 

Option Explicit 

'Set references: 

'Microsoft Outlook 11.0 Object Library 

Dim MyOIApp As Outlook. Application 

Private Sub Ottieni_nome(ByRef Nome As String) 

'Ottengo il nome del contatto visto che 

'Outlook mi da "nomecontatto (indirizzo@contatto.it)" 

Dim Pos As Integer 

'Ottengo la posizione della parentesi aperta 

Pos = InStrRev(Nome, "(") 

'Elimino la parte con l'indirizzo 

Nome = Left$(Nome, Pos - 2) 

End Sub 

Private Sub Form_Load() 



Dim Rubrica As AddressLists 

Dim Record As AddressEntry 

Dim Name As String 

'Apro Microsoft Outlook 

Set MyOIApp = New Outlook. Application 

'Apro la rubrica 

Set Rubrica = MyOIApp. Session. AddressLists 

'Apro il primo contatto 

Set Record = Rubrica. Item(l),AddressEntries.GetFirst 

'Controllo che ci sia almeno un contatto 

While Not (Record Is Nothing) 

Name = Record. Name 

Ottieni_nome Name 

MsgBox Name & vbCrLf & Record. Address 

'Passo al contatto successivo 

Set Record = Rubrica. Item(l).AddressEntries.GetNext 



'Contatti terminati 

MsgBox "Indirizzi terminati 

'Chiudo il contatto 

Set Record = Nothing 

'Chiudo la rubrica 

Set Rubrica = Nothing 
'Chiudo Microsoft Outlook 

MyOIApp. Quit 

Set MyOIApp = Nothing 
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Private Declare Function SetWindowLong Lib "user32" Alias 

"SetWindowLongA" (ByVal hwnd As Long, ByVal nlndex As Long, 
ByVal dwNewLong As Long) As Long 
Private Declare Function CalIWindowProc Lib "user32" Alias 

"CalIWindowProcA" (ByVal IpPrevWndFunc As Long, ByVal hwnd As 
Long, ByVal Msg As Long, ByVal wParam As Long, ByVal IParam As 

Long) As Long 
Private IpPrevWndProc As Long 
Private frmToClose As Form 
'Per gestire il mouse 
Public Declare Function SetCapture Lib "user32" (ByVal hwnd 

As Long) As Long 
Public Declare Function ReleaseCapture Lib "user32" () As Long 
Private Function WindowProcToCloseFormOnLostFocus(ByVal hwnd As 
Long, ByVal iMsg As Long, ByVal wParam As Long, ByVal IParam 

As Long) As Long 
WindowProcToCloseFormOnLostFocus = CallWindowProc( 

IpPrevWndProc, hwnd, iMsg, wParam, IParam) 

If iMsg = WM_NCACTIVATE Then 

If wParam = NO_ACTIVE Then 

Unload frmToClose 
UnhookFormToClose 

End If 

End If 

End Function 

Public Sub HookFormToClose(frm As Form) 
'Per eliminare eventuali hook precedenti 

If IpPrevWndProc <> Then 

UnhookFormToClose 

End If 

'Hook al form frm 

IpPrevWndProc = SetWindowLong(frm.hwnd, GWL^WNDPROC, 
AddressOf WindowProcToCloseFormOnLostFocus) 

Set frmToClose = frm 
End Sub 

Public Sub UnhookFormToCloseO 
If IpPrevWndProc <> Then 

Cali SetWindowLong(frmToClose.hwnd, GWL_WNDPROC, 

IpPrevWndProc) 
Set frmToClose = Nothing 

IpPrevWndProc = 

End If 

End Sub 




JAVA 



COMPRIMERE UNA DIRECTORY 

Attraverso il package java.util.zip, Java fornisce alcuni 
semplici meccanismi per comprimere e decomprimere 
file. Il metodo zipDir mostra come comprimere ricorsiva- 
mente un albero di directory. Il metodo accetta un ogget- 
to String come directory da comprimere e un oggetto 
ZipOutputStream che rappresenta il file compresso. Il me- 
todo zipDir non include le directory vuote nell'archivio 
zip creato. 



try 

{ 

//crea un ZipOutputStream nel quale comprimere i dati 
ZipOutputStream zos = new 

ZipOutputStream(newFileOutputStream(". \\curDir.zip")); 
//partiamo dal presupposto che esista una directory 
chiamata inFolder 
//chiama il metodo zipDir 
zipDir(".\\inFolder", zos); 
//chiude lo stream 
zos.close(); 

} 

catch(Exception e) 

{//cattura le eccezioni} 

//codice per il metodo 

public void zipDir(String dir2zip, ZipOutputStream zos) 

{ 

try 

{ 

//crea un nuovo oggetto File 

zipDir = new File(dir2zip); 

//ottiene l'elenco del contenuto delle directory 

String[] dirList = zipDir.list(); 

byte[] readBuffer = new byte[2156]; 

int bytesln = 0; 

//il loop seguente scansiona ricorsivamente l'albero delle 

//directory e comprime i file individuati 

for(int i=0; i<dirList.length; i+ + ) 

{ 

File f = new File(zipDir, dirList[i]); 

if(f.isDirectoryQ) 

{ 

//se l'oggetto file è una directory chiama nuovamente la funzione 
//per aggiungere nell'archivio tutto il contenuto delle directory 
//ricorsivamente 

String filePath = f.getPathQ; 

zipDir(filePath, zos); 
//ripete nuovamente il ciclo 
continue; 

} 

//se arriva qui, significa che l'oggetto File f 

//non è una directory, 

//quindi crea un FilelnputStream invece di f 

FilelnputStream fis = new FilelnputStream(f); 

ZipEntry anEntry = new ZipEntry(f.getPath()); 

zos.putNextEntry(anEntry); 

//scrive il contenuto del file in ZipOutputStream 

while((bytesln = fis.read(readBuffer)) != -1) 

{ 

zos.write(readBuffer, 0, bytesln); 

} 

//chiude lo stream 
fis.close(); 

} 

} 

catch(Exception e) 

{ 

//cattura 
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VISUALIZZARE DOCUMENTI 
PDF DA UIU'APPLET 

La soluzione proposta utilizza il metodo showDocumentQ 
dell'interfaccia pubblica AppletContext per visualizzare 
documenti PDF direttamente in una applet Java. Inoltre, 
necessita di un browser con installato il plugin di Acrobat 
Reader. 

package play.pdf; 

import java. applet.*; 

import java.awt.*; 

import java. net. URL; 

public class PDFViewer extends Applet { 

Font font = new Font("Dialog", Font.BOLD, 24); 

String str = "PDF Viewer"; 
int xPos = 5; 

public String getAppletInfo() { 
return "PDFViewer\n" + 

"\n" + 

"File creato con....\n" + 

} 

public void paint(Graphics g) { 
g.setFont(font); 
g.setColor(Color.black); 
g.drawString(str, xPos, 50); 

} 

public void start() { 
super.start(); 

try { 

URL uri = new URL( "http://www.generic.com/documen 

to. pdf" ); 

this.getAppletContext().showDocument( uri, "_blank" ); 
} catch (Exception e) { 

System. err.println( "Errore: Impossibile visualizzare il 
documento!" ); 

} 

} 





ASP 



FILTRARE UN RECORDSET 

È possibile filtrare il risultato di una query su un record- 
set utilizzando la proprietà Filter al posto della clausola 

WHERE. 



RICERCA FULL-TEXT 
ini UHI DB ACCESS 

Anche se SQL Server è uno dei database più robusti e sca- 
labili per la ricerca full-text, molti sviluppatori continua- 
no ad utilizzare Access quando si tratta di applicazioni 
che necessitano di database piccoli e poco complessi. È 
possibile effettuare ricerche full-text all'interno di un 
database Access semplicemente concatenando i nomi 
dei campi all'interno delle query SQL. Il codice seguente 
utilizza una query SQL nella quale combina i campi 
FirstName e LastName utilizzando la parola chiave LIKE, 
dopodiché assegna il contenuto della query al metacarat- 
tere an. Il codice seguente utilizzato all'interno del data- 
base NorthWind ottiene l'elenco degli impiegati il cui 
nome contiene i caratteri "an". 

<%@ Language=VBScript %> 

<HTML> 

<HEAD> 

</HEAD> 

<B0DY> 

<!— #include File="adovbs.inc"— > 

<% 

Set conn = Server.CreateObject("ADODB. Connection") 

Set rs = CreateObject("ADODB.Recordset") 

conn. Open Application("Connection5_ConnectionString") 
rs.CursorType = adOpenStatic 
rs.LockType = adLockReadOnly 
rs.CursorLocation = adUseClient 
Set rs.ActiveConnection = conn 

rs.Source = "SELECT * FROM Employees WHERE FirstName + 

Lastname LIKE '%an%'" 

rs.Open 

Do While Not rs.EOF 

Response.Write rs("FirstName") &" " & rs("LastName") &"<br>" 
rs.MoveNext 

Loop 

rs.Close 

conn.Close 

Set rs = Nothing 

Set conn = Nothing 

%> 

</BODY> 

</HTML> 



Dim objRS, objFilter ' As ADODB.Recordset 

Dim dcnDB ' As ADODB. Connection 

Set dcnDB = Server.CreateObject("ADODB. Connection") 

dcnDB. Open "Some connection string" 

Set objRS = Server.CreateObject("ADODB.Recordset") 

objRS.Open "SELECT * FROM tblOrders", dcnDB, adOpenStatic 
objRS. Filter = "CustomerName Like %Smith%" 
Set objFilter = objRS 




DELPHI 



FORMATTARE 
UM FLOPPY DISK 

La procedura proposta, che altro non è che la risposta 
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all'evento "OnClick" di un bottone (Buttonl) messo su di 
una forni chiamata Formi, mostra come utilizzare Delphi 
per formattare un dischetto. Come si può notare, la Shell- 
Execute esegue il programma Rundll32.exe contenuto, nel 
nostro caso, nella cartella C:\Winnt \system32. Nella Uses 
principale del programma è necessario dichiarare la unit 
ShellApi. 
Il programma è stato testato su Windows 2000. 

procedure TForml.ButtonlClick(Sender: TObject); 

begin 

ShellExecute( Application. Handle,Pchar('Open'), 

Pchar('C:\Winnt\system32\Rundll32.exe'), 

Pchar('Shell32.dll,SHFormatDrive'), 

Pchar('C:\Winnt\system32'),SW_SHOWNORMAL); 

end; 



RIEMPIRE DI ZERI 

UNA VARIABILE DI TIPO 

STRIIUG CONTENENTE NUMERI 

Spesso gli utenti si trovano a digitare codici numerici pre- 
ceduti da un certo numero di zeri e chiedono al program- 
matore un metodo per evitare di digitare tutti gli zeri. 
La funzione che segue, messa in un programma Delphi, 
non fa altro che riempire di zeri una variabile di tipo 
string che contiene un numero. Come si può osservare la 
funzione ha due parametri: il primo è la stringa da riem- 
pire di zeri, il secondo indica il numero di caratteri di cui 
dovrà essere costituita la stringa restituita dalla funzione. 
Per esempio, se il primo parametro contiene il numero 45 
e il secondo contiene il valore 8, la stringa restituita dalla 
funzione sarà 00000045. 

function RiempiDiZeri(S: String ;NumCar:Integer): String; 

Var 

SNumiInteger; 

SStnString; 
begin 

Result: = S; 

if So" then 

begin 

SNum: = StrToInt(S); 

SStr:=StringOfChar('0',NumCar)+IntToStr(SNum); 

Resulti =Copy(SStr,(Length(SStr)-NumCar) + l,NumCar); 

end; 
end; 



vari menù su altrettanti file di testo. Le indicazioni ripor- 
tate di seguito illustrano un possibile modo di consegui- 
re questo risultato. 

Salvare in un file di testo chiamato MENUTXTle seguenti 
informazioni: 

l,Menù Generale, 
2,Addizione,l 
2, Sottrazione, 2 
2, Moltiplicazione, 3 
2, Divisione, 4 

2,-,0 

2, Uscita Programma, 5 

Il file MENU. TXT deve risiedere nella stessa cartella in cui 
andremo a salvare il programma Delphi. 
Come si può osservare, il file è stato suddiviso in tre co- 
lonne: la prima contiene il livello del menù a cui appar- 
tiene ciascuna scelta, la seconda contiene la descrizione 
delle singole scelte e la terza è dedicata al numero della 
scelta. 

Nella penultima scelta è stato messo un trattino nella 
seconda colonna ad indicare che nel menù dovrà compa- 
rire una riga di separazione fra le prime quattro scelte 
(Addizione, Sottrazione, Moltiplicazione, Divisione) e l'ul- 
tima scelta (Uscita Programma). 

Nella Uses principale del programma è necessario dichia- 
rare la unit Menus. 

Introdurre una sezione Var, subito prima di Implementa- 
tion, scrivendo il seguente codice: 



FMENUOOOIM: TFMENU0Q01M; 

MioMenu: TMainMenu; 

MenuGeniTMenuItem; 
SottoScelte:TMenuItem; 
Menu Dinamico :TString List; 

Nella sezione Type del programma dichiarare le tre proce- 
dure che seguono: 

procedure Crea Menu(FileMenu: String); 

procedure CreaSubScelte(Nome:String; Numero:Integer); 

procedure SceltaClick(Sender: TObject); 

Scrivere anche il codice relativo alle tre procedure nel 
modo seguente: 



CREARE UHI MENU PARTENDO 
DA UHI FILE DI TESTO 

Spesso, particolarmente nei programmi gestionali, si ha 
la necessità di creare dei menu in maniera dinamica. Per 
esempio, in un software che funziona in rete si potrebbe 
decidere di far vedere ai singoli utenti solo le scelte nelle 
quali sono autorizzati ad entrare. 

Questo scopo può essere facilmente raggiunto creando 
un menù diverso per ciascun utente e memorizzando i 



procedure TForml.CreaMenu(FileMenu: String); 
Var 

Riga, NomeScelta, Livello:String; 

i, NumScelta, Posizione:Integer; 
begin 

// Leggo il Menu dal File di Testo 

Menu Dinamico :=TString List. Create; 

Menu Dinamico. LoadFromFile(FileMenu); 

// Creo il Menu 
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MioMenu.Free; 
MioMenu:=Nil; 
MioMenu:= TMainMenu.Create(Self); 

// Creo le Scelte 

For i:=0 to MenuDinamico.Count-1 do 

begin 

Riga: = MenuDinamico.Strings[i]; 

Posizione: =Pos(Y,Riga); 

Uvei lo :=Copy (Riga, 1, Posizione- 1); 

Riga:=Copy(Riga, Posizione+l,Length(Riga)-Posizione); 

Posizione: = Pos(Y,Riga); 

NomeScelta:=Copy(Riga,l,Posizione-l); 

NumScelta:=StrToInt(Copy(Riga,Posizione+l,l)); 

// Creo le Scelte di Primo Livello 

if Livello = 'l' then 

begin 

MenuGen := TMenuItem.Create(Self); 

MenuGen.Caption := NomeScelta; 

MioMenu.Items.Add(MenuGen); 
end; 

// Creo le Scelte di Secondo Livello 
if Livello = v 2' then 

CreaSubScelte(NomeScelta,NumScelta); 



if TMenuItem(Sender).Tag = 2 then 


begin 


// Codice da Eseguire per 


la Seconda Scelta 


end; 


if TMenuItem(Sender).Tag = 


3 then 


begin 


// Codice da Eseguire per 


la Terza Scelta 


end; 


if TMenuItem(Sender).Tag = 


4 then 


begin 


// Codice da Eseguire per 


la Quarta Scelta 


end; 


if TMenuItem(Sender).Tag = 


5 then 


Forml.Close; 


end; 



Nell'evento On Create della Form scrivere il seguente co- 
dice: 

CreaMenu('MENU.TXT'); 



end; 

Menu Dina mico.Free; 

Menu Dinamico : = Nil; 

end; 

procedure TForml.CreaSubScelte(Nome:String; Numero:Integer); 
begin 

SottoScelte := TMenuItem.Create(Self); 

SottoScelte.Caption := Nome; 

SottoScelte.Tag: = Numero; 

SottoScelte. OnClick := SceltaClick; 

MioMenu.Items[Q].Add(SottoScelte); 

end; 

procedure TForml.SceltaClick(Sender: TObject); 

Var 

I:Integer; 
begin 

for I := to MenuGen. Count-1 do 
begin 
if MenuGen. Items[I].Checked then 
MenuGen. Items[I].Checked: = False; 
end; 

TMenuItem(Sender).Checked:=True; 

if TMenuItem(Sender).Tag = l then 
begin 

// Codice da Eseguire per la Prima Scelta 
end; 



• 



Questo mese 
in palio il nuovo 
combinato 

TASTIERA ^__ 
+ MOUSE ~^ 
OTTICO WIRELESS 




Trust 280KS 

Keyboard 

& Wireless 

optical mouse 



Inviaci la tua soluzione ad un problema di 

programmazione, una faq, un tip... 

Tra tutti quelli giunti mensilmente in redazione, 

saranno pubblicati i più meritevoli e, fra questi, 

scelto il Tip del mese 
PREMIATO CON UN FANTASTICO OMAGGIO! 

Invia i tuoi lavori a ioprogrammo@edmaster.it 
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JPEG a rischio di virus, il mito diventa realtà! 

Metti il virus 
nella JPEG 

Nel 1994 una e-mail metteva in guardia da un fantomatico virus 
annidato nelle JPEG. Oggi, nel 2004, un bug dei sistemi Microsoft ha 
trasformato in realtà ciò che era solo una leggenda metropolitana! 



Quante immagini allegate alle e-mail ricevete 
ogni giorno? Di sicuro tante. E quante volte vi è 
stato detto che i virus non possono annidarsi 
nelle immagini? Innumerevoli! Da oggi però le cose 
cambiano, perché è giunto il momento di temere e dif- 
fidare anche delle immagini. A distanza di qualche 
mese dagli eventi e dalle conseguenze scaturite dal bol- 
lettino di sicurezza MS04-028, mi chiedo cosa potranno 
mai pensare i poveri utenti di Microsoft quando scopri- 
ranno di poter essere infettati semplicemente visualiz- 
zando un'immagine JPEG! Una innocua immagine può 
ora trasformarsi in una micidiale arma in mano agli 
hacker e portare con sé virus, worm, trojan e qualsiasi 
altra minaccia. Su questa vulnerabilità legata al proces- 
sore di immagini JPEG di Microsoft (chiamato GDI+) e 
su tutta la vicenda del bollettino MS04-028 discutere- 
mo ampiamente in queste pagine: analizzeremo uno 
degli overflow (...l'ennesimo!) che potrebbe causare 
una mega-infezione di massa simile a quella del worm 
Sasser, avvenuta qualche tempo fa. 



GDIPLUS, 
UNA LIBRERIA 
TROPPO CONDIVISA 

Leggendo per la prima volta il bollettino MS04-028 sul 
sito Microsoft, la cosa che balza subito agli occhi è l'in- 
credibile serie di prodotti affetti dalla vulnerabilità: 
Windows XP (con e senza Service Pack 1), Windows 
Server 2003, tutta la famiglia di Office (2000, XP e 2003), 
Project, Visio, Visual Studio, addirittura il .NET Fra- 
mework. . . non si finisce più! Ma perché tutto questo? È 
possibile che una manciata di byte errati nel codice di 
una DLL possano mettere in ginocchio la serie comple- 
ta di prodotti di una mega-softwarehouse quale è 
Microsoft? Paradossalmente, Windows 2000, conside- 
rato da Microsoft ormai un antenato ormai da dimenti- 
care, fino al Service Pack 4 non risulta affetto da tale 



bug, perché casualmente non utilizza e non dispone 
del componente vulnerabile che ha fatto nascere tutto 
il problema, ovvero la libreria GDIPLUS.DLL. 
GDI+ (Graphics Device Interface) è il componente di 
sistema che (assieme a GDI32.DLL) fornisce la maggior 
parte di funzionalità nel processamento di immagini e 
nel trattamento di oggetti grafici in generale. Tanto per 
capirci GDIPLUS.DLL esporta ben 609 funzioni dispo- 
nibili a qualsiasi programma che abbia bisogno di 
manipolare bitmap, effettuare trasformate di matrici, di 
texture, disegnare linee, poligoni, ellissi e tutto ciò che 
in generale ha a che fare con la grafica. Pare infatti che 
questa libreria sia talmente utile da essere sfruttata da 
una serie di prodotti di terze parti (tipo ArchiCAD, 
ACDsee, ecc.) in maniera intensiva. Il bug scoperto in 
GDI+ risiede in una funzione dedicata al processamen- 
to delle immagini JPEG, in particolare quella usata da 
EXPLORER per estrarre i commenti testuali racchiusi 
nei file JPG mentre si naviga nelle cartelle del disco fis- 
so. L'esistenza di una vulnerabilità in un componente 
critico (e soprattutto tanto condiviso) come questo rap- 
presenta naturalmente un grave problema per Win- 
dows, anche perché - come la storia ci insegna - quan- 
do tutto il mondo si ritrova ad usare lo stesso sistema 
operativo (e la stessa libreria buggata!), automatica- 
mente c'è il rischio di dover fronteggiare infezioni di 
massa su scala mondiale, causate da worm in grado di 
sfruttare tale vulnerabilità 



UHI BUG "VECCHIO" 
DI QUATTRO ANNI! 

La vulnerabilità di GDI+ fa la sua comparsa sulla mai- 
ling list Full-Disclosure intorno alla metà di Settembre 
2004, quasi in concomitanza col bollettino MS04-028. 
L'advisory viene postato dall'esperto di sicurezza Nick 
DeBaggis, che decide di non includere nessun exploit, 
fornendo tuttavia tutti i dettagli tecnici sul problema. 



ÙCDQ 

Exploit_85.zip 



^ 



WEB 
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SERVICE 
PACK 2... 
IMMUNE, MA 
Moni TROPPO! 

Windows XP con Servi- 
ce Pack 2 è immune al 
problema di GDIPLUS 
perché contiene una 
versione fixata della 
libreria. Tuttavia molti 
si chiedono cosa 
potrebbe succedere ad 
un sistema WinXP-SP2 
dove viene installato - 
in un secondo 
momento - Office XP o 
Visio, che riporrebbero 
sul sistema una 
versione difettosa di 
GDI+. 
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GDI+ 
SCANNER TOOL 

Poiché si è appurato 

che nel sistema 

operativo potrebbero 

essere presenti diverse 

versioni della stessa 

libreria CDIPLUS.DLL 

(installate magari a 

software di terze 

parti), sia Microsoft, sia 

l'istituto SANS, hanno 

rilasciato due tool in 

grado di rilevare le 

versioni difettose di 

GDI+. I tool sono 

reperibili ai seguenti 

indirizzi: 

http://isc.sans.org/ 

qdiscan.php 

www, m icrosoft.com/ 

security/bulletins/ 

200409 ìpeq.mspx 

NON SOLO 
GDIPLUS.DLL 

Il ricercatore Kile Quest 

ha pubblicato una 

analisi dettagliata 

dell'overf low delle 

JPEG, scoprendo che 

esistono altre librerie 

suscettibili al problema 

(MSO.DLL e VGX.DLL). 

Nel suo ambiente di 

test è riuscito a creare 

un'immagine JPEG 

malformata in grado di 

eseguire codice remoto 

attraverso la semplice 

visione con Internet 

Explorer. Il documento 

si può reperire su 

www.unital.com/research/ 

ms jpeq.pdf. 



La prima cosa che desta subito scalpore è l'intestazio- 
ne dell'advisory che recita più o meno così: 



FromiNickD. 



To: Full-Disclosure 



Microsoft GDIPlus.DLL JPEG Parsing Engine Buffer 
Overflow 

Advisory: September 14, 2004 
Reported: October 7, 2003 

Si legge "Riportato: Ottobre 7, 2003". Ciò significa che 
questa vulnerabilità è presente nei nostri sistemi da 
quasi un anno e che qualcuno ha preferito tenerla na- 
scosta fino ad oggi, piuttosto che divulgarla. A parte 
questa piccola divagazione, si scopre - indagando più a 
fondo nell' advisory - che un simile problema di pro- 
cessamento delle JPEG era stato già scoperto nel lonta- 
no 2000 nel codice del browser Netscape e che nessuno 
all'epoca aveva provato a sondare altri prodotti per ve- 
rificare l'esistenza della stessa vulnerabilità. Questa 
condivisione di vulnerabilità tra Netscape e Windows 
nel processamento delle JPEG suona comunque stra- 
na: casualità o qualche "copia&incolla" di troppo? 



RADIOGRAFIA 
UNA JPEG 



Per studiare e capire la vulnerabilità di GDI+, è indi- 
spensabile conoscere qualcosa in più su questo forma- 
to grafico. Il formato JPEG codifica le immagini in una 
sequenza ordinata di markers, seguiti dai parametri 
legati ai markers e da segmenti dati relativi all'immagi- 
ne, compressi usando particolari trasformate matema- 
tiche (DCT, FFT). Un marker è sempre identificato 
all'interno del file JPEG dal byte esadecimale "Fi 7 " ed è 
seguito sempre da un secondo byte che serve a defini- 
re la tipologia di marker. Un elenco dei principali 
markers presenti nelle JPEG è riportato in Tabella 1 (l'e- 
lenco non è esaustivo). Detto questo, chiunque di voi, 
aprendo una JPEG con un editor esadecimale, riuscirà 



MARKER 


NOME SIMBOLICO 


DESCRIZIONE 


FFD8 


SOI 


Start Oflmage - tutte le immagini JPG iniziano 
con questa intestazione 


FFEO 


JFIF marker 


Contiene la sigla ASCII-Z "JFIF" e una serie di 
informazioni sulla versione del formato usato e 
sulla densità dei pixel 


FFDB 


DQT 


Define Quantization Table- tavola di 
quantizzazione, contenente in genere 64 bytes 


FFC4 


DHT 


Define Huffman Table - tavola con i codici di 
Huffman usati nella compressione 


FFCO 
FFCl 


SOF 


Start Of Frante 


FFDA 


SOS 


Start OfScan 


FFFE 


COM 


Comment Marker - contiene eventuali commenti 
testuali (ASCII) inclusi nell'immagine 


FFD9 


EOI 


End Oflmage - chiusura della JPEG e fine del file 


i TABELLA h Principali marker del formato JPEG 



a leggere qualcosa in più nel formato e potrà capire 
come è strutturata. Ogni marker (ad eccezione di SOI e 
EOI) è in genere seguito da alcuni parametri e poi dai 
dati veri e propri. Se consideriamo ad esempio il 
marker "FFEO", avremo la seguente struttura dati che 
segue immediatamente dopo il marker : 

FFEO -"JFIF marker" 

2 bytes L, lunghezza totale del marker, inclusi i 2 

bytes col valore della lunghezza 
5 bytes la string ASCIIZ "JFIF" ovvero la sequenza 

"4A46494600" 
2 bytes versione (01 o 02) 

1 byte densità {0=no units; 1 =X, Fsono dotsXinch, 

2=X,Y sono dotsXcm) 

2 bytes X-density 
2 bytes Y-density 

1 byte XN-thumbnail (0=no thumbnail) 

2 byte YN-thumbnail (0=no thumbnail) 
(3*N) bytes N valori RGB (3 bytes) per i pixel della 

thumbnail (N=XN*YN) 

Il marker COM {FFFE) è evidenziato nella tabella per- 
ché è proprio il punto in cui la libreria GDI+ risulta vul- 
nerabile all'overflow. La definizione di questo marker è 
molto semplice: 

FFFE -"COM marker" 

2 bytes L, lunghezza totale del marker, inclusi i 

due byte col valore della lunghezza 
L-2 bytes una qualsiasi stringa ASCII, usata come 

commento. 



ANALISI DELLA 
VULNERABILITÀ GDI+ 

Nell'advisory si legge che ponendo "00 00" o in alterna- 
tiva "00 01 "come lunghezza totale (E) del marker COM, 
si può innescare l'overflow della libreria GDIPLUS.DLL, 
quando questa cerca di estrarre e leggere il commento 
di una JPEG. 

L'algoritmo interno della libreria esegue grosso modo 
questi passi (documentati egregiamente da K. Quest 
nel suo documento di analisi su GDI+): 

1) alloca (1+2) byte nell'Heap H (dovranno contenere 
tutta la struttura del marker COM più i 2 byte dell'i- 
denflticatore del marker "FFFE'); 

2) copia in DWORD [H] l'identificatore del tipo di mar- 
ker (cioè "FFFE'); 

3) copia in DWORD [H+2] i successivi 2 byte, che iden- 
tificano la lunghezza totale (L) del marker; 

4) calcola la lunghezza reale del commento come L-2, 
sottraendo dalla lunghezza totale E, i due byte che 
corrispondono al valore della lunghezza; 

5) copia i successivi (L-2) byte di commento nel- 
l'Heap (fatto tramite meincpy) 
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Traducendo in assembly questa sequenza si ottiene il 
seguente codice, estratto proprio da GDIPLUS.DLL (il 
registro ESI contiene proprio il valore L nel punto in cui 
siamo considerando il codice): 



lea eax, [esi+2] ; carica in EAX il valore (L+2) - passo (1) 

push eax 

cali sub_588518 ; alloca la memoria richiesta da EAX nell'heap 

test eax, eax ; allocazione riuscita? 

mov [ebp+IpMem], eax 

jz loc_5CC58A 

mov ex, word ptr [ebp+arg_4] ; copia il marker "FF 

FÉ" nell'heap 
mov [eax], ex 

mov ex, word ptr [ebp+arg_0] 
lea edx, [esi-2] ; Len-2 bug! 



mov ecx, edx 
mov eax, ecx 
shr ecx, 2 
rep movsd 



overflow dell'heap 



Il perché usando una lunghezza pari "00 00" o "00 01 " si 
scatena l'heap overflow adesso dovrebbe essere ora 
chiaro: il programmatore di GDI+ ha fatto l'assunzione 
che il valore I specificato subito dopo il marker "FFFE" 
sia sempre L>=2, proprio perché tale valore, da specifi- 
che, deve includere sempre i 2 byte iniziali contenenti 
la lunghezza. Un commento con lunghezza zero, avreb- 
be comunque richiesto un valore L=2, di conseguenza 
al programmatore sarà sembrata una buona idea calco- 
lare al volo, risparmiando qualche istruzione, la lun- 
ghezza del commento come (L-2), senza effettuare con- 
trolli su tale valore (I è veramente >=2 ?) e senza consi- 
derare che una JPEG malformata "ad hoc" dagli hacker 
avrebbe potuto un giorno contenere i valori critici 
"0000" e "0001". Dal codice mostrato si nota che il valo- 
re [ESI-21 (contenente L-2) viene poi spostato in ECX ed 
è usato come contatore per pilotare l'istruzione "REP 
MOVSD", che sposta nell'heap - uno ad uno - i restanti 
bytes del commento JPEG. 

Usando una lunghezza pari a (o ad 1), in EDX viene 
caricato un valore negativo (0-2 = -2 = OxFFFE unsi- 
gned), che convertito a 32-bit (OxFFFFFFFE) causa uno 
spostamento nella memoria Heap di un numero spro- 
positato di byte (circa 4 GB) e da qui scaturisce l' over- 
flow. Ulteriori analisi hanno mostrato che l'overflow 
può essere innescato - con motivi identici a quelli espo- 
sti - usando anche i marker "FFED", "FFE1 ", "FFE2". 



EXPLOIT E SHELLCODE 
DISPONIBILI 

Per testare la vulnerabilità basta quindi aprire una qual- 
siasi JPEG con un editor esadecimale e variare i 2 byte 



EXPLOIT 


AUTORE 


PAYLOAD 


LINGUAGGIO 


www.k-otik.com/exrjloits/ 
09222004.ms04-28.sh.php 


Perplexy 


Solo Overflow (no shellcode) 


Script .sh / Perl 


www.k-otik.com/exploits/ 
09222004.ms04-28-cmd.cphp 


FoToZ 


Lancia una shell "cmd.exe" 


C++ 


www.k-otik.com/exploits/ 
09232004.ms04-28-admin.sh.Dhp 


Elia Florio 


Aggiunta di un utente 

"X" nel gruppo Administrators 


Script .sh / Perl 


www.k-otik.com/exploits/ 
09252004.JpeqOfDeath.cphp 


John Bissell 


BindShell, ReverseShell 


C++ 


JPEG Downloader 1.0 
(sorgente non divulgato) 


ATmaCA (?) 


Scarica un file .EXE da un URL 
Internet e lo esegue 


? 


^ TABELLA 2-. Exploit correntemente disponibili per la vulnerabilità MS04-D28 J 



di lunghezza del marker "FFFE" impostandoli a "00 00" 
(o"00 01"). 

L'overflow si innesca nel momento in cui Windows 
cerca di estrarre il commento dalla JPEG: ciò avviene in 
EXPLORER quando si sfogliano le cartelle locali e col 
mouse ci si sofferma su un'immagine JPEG o quando 
questa viene selezionata. È in questa occasione che vie- 
ne usata, tramite una serie di chiamate innestate, la 
funzione difettosa di GDIPLUS.DLL col conseguente 
overflow che termina con un crash di EXPLORER. 
A seguito dell'analisi della vulnerabilità sono stati pub- 
blicati, a distanza di pochi giorni l'uno dall'altro, i 
seguenti exploit, pubblicamente disponibili sul sito di 
sicurezza K-Otik e allegati nella rivista, con alcuni 
esempi di JPEG malformate (che potrebbero essere se- 
gnalate come potenziali virus dai vostri antivirus). 
Un breve riassunto della situazione lo trovate riportato 
nella tabella 2. 



CONCLUSIONI 

Fuggire dall'heap e prendere il controllo dell'esecuzio- 
ne non è comunque semplice, come nel caso degli 
stack overflow. Tuttavia, come si è visto nei diversi test 
eseguiti, l'overflow finisce col controllare il registro 
EDX, che va a scrivere alcuni byte al posto giusto, va- 
riando l'indirizzo di ritorno e di conseguenza alterando 
il flusso dl'esecuzione di GDIPLUS. I diversi exploit 
creati prevedono il salto, tramite l'inserimento del valo- 
re di ritorno giusto in EDX, ad una locazione dell'heap 
precisa dove sono caricati i bytes dell'immagine JPEG. 
Se nell'immagine viene quindi inserito uno shellcode 
ben congegnato al posto giusto (preceduto da un tap- 
peto di NOP), è possibile farlo eseguire. La lunghezza 
dello shellcode è stata stimata fino ad un massimo di 
2500 byte, che sono tantissimi! L'unica restrizione è che 
lo shellcode non può contenere la sequenza "FF D9"e 
altri caratteri speciali [NUL, FF) che potrebbero essere 
confusi come campi dell'header JPEG. 
Al momento esistono in circolazione diversi tool in gra- 
do di trarre vantaggio da questa vulnerabilità, ma non è 
escluso che in queste ore non faccia la comparsa su 
Internet il primo e temutissimo JPEG-Worm della sto- 
ria! 

Elia Florio 




SUL WEB 



K-Otik - Bollettino con 
exploit e pericoli 
derivanti dalle JPEG 

www.k-otik.com/news 

/09232004.MS04- 

028Threat.php 



Bollettino ufficiale 
MS04-028 sul 
componente 
GDIPLUS.DLL, con 
relativa patch 
www.microsoft.com/ 
tech net/secu ritv/bu I leti n/ 
ms04-028.mspx 

Advisory originale del 
bug sulle JPEG per 
Netscape (anno 2000) 

www.openwall.com/ 

advisories/OW-002- 

netscape-jpeq.txt 

Analisi del bug 
effettuata da Nick 
DeBaggis 

www.securiteam.com/ 

windowsntfocus/ 

5QP0C1FE0Y.html 

Informazioni sul 
formato JPEG e sui 
marker 

www.obrador.com/ 

essentialjpeq/ 

headerinfo.htm 

www.funducode.com/ 

freec/Fileformats/format3 

/format3b,htm 
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Un semplice circuito per pilotare il mondo! 

Radiocomando per PC 

In un mondo dove la connettività diviene sempre più "senza fili" 
realizziamo un radiocomando per PC, dotato di una portata di oltre 
500 metri: con componenti a basso costo e alta affidabilità 




U CD Ci WEB 

RadiocomandoPC.exe 



*JZ 



Radiocomando ON / OFF per PC 



mini nandù 


* SJt;'Ì[; : GF3'H"ì 
r COM2(02FSH] 


f Masler Power DN /OFF 




$ Canale 10N/0FF 

Segnale Trasmesso ( ) 
Frequenza Pollante 




| DTR O CTS • 

DSR # 

RTS | O RI • 

CD • 


LlI J jJ 



mairto:spuntosott@tiscali.it mailto:pcexplorei@elisys.it www.pcexplorer.it 



Fìg. 1: 1 comandi della applicazione di gestione del radio- 
comando sono semplici ed immediati 



Sistemi di sicurezza, porte e cancelli, sistemi di 
irrigazione e di automazione: sono solo alcu- 
ne delle possbilità offerte da sistema di con- 
trollo proposto questo mese. In questa sede voglia- 
mo realizzare un sistema radiocomandato ON-OFF 
ad un canale, comandato da un computer per mez- 
zo della porta seriale: desideriamo comandare l'ac- 
censione di un LED a distanza, che potrà essere 
sostituito facilmente, attraverso un apposito stadio 
di potenza, con qualunque attuatore elettromecca- 
nico, come ad esempio servomeccanismi a motore, 
elettrovalvole e sistemi di illuminazione. Tutte le in- 
formazioni necessarie alla realizzazione del sistema 
saranno contenute in 
questo articolo, parten- 
do dal circuito elettroni- 
co, per giungere al soft- 
ware di controllo: sarò 
ovviamente a disposizio- 
ne dei docenti e degli 
studenti che vogliano 
approfondire l'argomen- 
to sul forum di ioPro- 
grammo, oppure attra- 
verso l'indirizzo di posta 
elettronica luca.spunto- 
ni@ioprogrammo. it. 



_JEJ*I 



in 




REQUISITI 



M4M.Wi.UM 



9 Programmazione 
| Delphi, concetti base 



ì 



di elettronica 

S.O. Win 9.x, ME, 2000, 
NT, XP 



\Mi^MW3 



Tempo di realizzazione 



IL PROGETTO 

Il principio generale di un radiocomando si basa su 
un trasmettitore a radiofrequenza e un ricevitore, 
entrambi sintonizzati su una determinata frequenza 
e dotati di un sistema di trasmissione delle informa- 
zioni comune, siano queste analogiche o digitali. 
Nella nostra applicazione utilizzeremo due moduli 
integrati a basso costo e alte prestazioni, che per- 
mettono di modulare una portante a radiofrequen- 
za, con modalità ON-OFF, consentendo la trasmis- 
sione di segnali digitali. Come antenna, utilizzeremo 
un semplice cavo elettrico rigido, di lunghezza op- 
portuna: più precisamente lungo un quarto della 
lunghezza d'onda della frequenza della portante. 



L'antenna in questione è detta marconiana (in ricor- 
do di Guglielmo Marconi. Poiché il nostro sistema a 
radicomando funziona ad una frequenza di 433.92 
Mhz, la lunghezza della nostra antenna sarà pari ad 
un quarto della lunghezza d'onda, ovvero L=C/(4*f) 
=3 *10 7 (4*4.33928)= 0,173 m=17,3 cm, dove C è la 
velocità della luce e / la frequenza di lavoro. Con 
questa antenna, semplice e compatta, ed il circuito 
proposto in queste pagine, è stata raggiunta una di- 
stanza di trasmissione di oltre cinquecento metri 
senza ostacoli (oltre settanta metri con edifici). Mo- 
dificando la configurazione dell'antenna ed inse- 
rendo un circuito amplificatore, è possibile aumen- 
tare considerevolmente la distanza di trasmissione. 




Fìg. 2: Un particolare del progetto montato 



IL TRASMETTITORE 

Il trasmettitore del nostro radiocomando è basato 
sul modulo TX-SAW-433/s-Z, della Aurei (www.au- 
rel.it) ed è destinato ad un impiego dove sia neces- 
saria la modulazione ON-OFF di una portante per la 
trasmissione di segnali digitali. Il trasformatore è 
conforme alle direttive europee sull'argomento. Il 
metodo di controllo del sistema viene ovviamente 
realizzato in modo tale che possa sfruttare le poten- 
zialità di un Personal Computer attraverso un colle- 
gamento tramite la porta seriale. Il circuito elettrico 
del trasmettitore non necessita di alcuna alimenta- 
zione esterna, dal momento che la piccola quantità 
di potenza necessaria viene prelevata dalla porta 
seriale del PC. Analizzando infatti lo schema elettri- 
co del trasmettitore, possiamo notare che la linea 
DTR (Data Transfer Ready) della seriale è collegata 
allo stabilizzatore di tensione IC1, che ha il compito 
di stabilizzare la tensione al valore di 5 Volts, neces- 
sario all'alimentazione del modulo trasmettitore. Il 
diodo DI provvede a "bloccare" la tensione negativa 
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Fig. 3: II trasmettitore non necessita di alcuna alimen- 
tazione estema: l'unica connessione necessaria è quella 
relativa alla porta seriale 

presente sulla linea DTR, quando questa si trova allo 
stato logico "LOW, dal momento che questo valore 
di tensione può raggiungere anche -25 Volts su alcu- 
ni PC. I condensatori Cl,C2e C3 provvedono a filtra- 
re ed a livellare la tensione stabilizzata da IC1 prima 
che raggiunga il modulo trasmettitore. Il deviatore 
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F/g. 4: Radiocomando: Il trasmettitore ha una portata effettiva di oltre cinquecen- 
to metri senza ostacoli ed oltre settanta tra gli edifici 



comando a distanza. Il circuito stampato e la dispo- 
sizione dei componenti sulla scheda vengono pub- 
blicati in queste pagine, inoltre per facilitarne la rea- 
lizzazione, sul CD sono disponibili gli schemi dei cir- 
cuiti in formato bitmap. 



IL RICEVITORE 

Il ricevitore del radiocomando è stato realizzato uti- 
lizzando il modulo 4M50RR30SF sempre della Aurei 
assemblando i pochi componenti elettronici per 
mezzo di PCExplorer light. Lo schema elettrico è 
davvero molto semplice: il modulo ricevitore viene 
alimentato dalla apparecchiatura PCExplorer light, 
dotata di alimentatori stabilizzati interni ed il segna- 
le ricevuto viene utilizzato per 
pilotare un LED, contenuto al- 
l'interno della stessa apparec- 
chiatura attraverso il transi- 
stor TRI e la relativa resistenza 
di base RI. Il condensatore di 
disaccoppiamento CI, viene 
posto in vicinanza del modulo 
ricevitore. Il circuito ricevitore, 
risulta di facile realizzazione, 
stabile ed affidabile e verrà 
ampliato nel prossimo nume- 
ro al fine di realizzare un siste- 
ma completo di trasmissione 
di dati digitali. 



SW1 permette di selezionare, come linea di trasmis- 
sione, TD (Tmnsmit Data) oppure RTS (Request To 
Sena). Questa opzione consente di implementare di- 
verse strategie di progettazione, consentendo l'uti- 
lizzo della UART contenuta nella porta seriale e della 
sua potenza operativa nel caso si desideri effettuare 
la trasmissione di dati, oppure di un sistema asin- 
crono qualora si voglia sviluppare un proprio siste- 
ma di controllo. A questo scopo gruppo di compo- 
nenti RI, TRI, R2 permette di convertire i segnali 
provenienti dalla porta seriale a livelli RS232 (fino a 
+-25V) in livelli logici TTL (0, +5V), oltre che fungere 
da NOT logico. In definitiva, con pochi componenti 
elettronici, siamo in grado di realizzare un circuito 
trasmettitore stabile, semplice ed affidabile, capace 
di essere impiegato in innumerevoli applicazioni di 



434 Mhz OOK Transmitter 
with dedicateci antenna 




Pin-out 

1) Ground 

2) Input mod. 

3) Input mod. 

4) Ground 

11) RFOulput 
13) Ground 
15) +V 



Fig. 5: La piedinatura del modulo trasmettitore è visibile 
in figura ( cortesia Aurei S.p.A. ) 



IL RADIOCOMANDO 

Abbiamo visto in queste pagine che il nostro radio- 
comando è composto da un trasmettitore e da un ri- 
cevitore: il lettore ha a disposizione tutti gli schemi 
elettrici e tutto il software necessario alla realizza- 
zione del progetto. Per facilitarne la realizzazione è 
possibile assemblare i componenti senza saldature 
per mezzo della apparecchiatura PC Explorer light, 
oppure utilizzando i soli componenti elettronici 
elencati a lato di queste pagine, per mezzo del loro 
montaggio su una comune basetta millefori, utiliz- 
zando un saldatore a sta- 
gno. L'assemblaggio dei 
componenti viene facili- 
tato osservando le im- 
magini riportate in que- 
ste pagine, disponibili 
anche nel file allegato 
alla rivista. Il lettore potrà 
reperire i componenti 
elettronici che utilizzere- 
mo per la costruzione del 
radiocomando in qua- 
lunque negozio di com- 




W \ 



COMPONENTI 



TRASMETTITORE 



Qnt. 



Componente 



Modulo TX-SAW 

-433/s-Z 



7805 



Transistor BC 107 



Diodo 1N41 48 



Resistenza 
10Kohm 1/4W 



Condensatori 
470uF15V 



Condensatore 
100 nF 



Deviatore a 
levetta 



RICEVITORE 



PCExplorer light 



Modulo 

4M50RR30SF 



Transistor BC 107 



Resistenza 
lOKohm 1/4W 



Condensatore 
100 nF 



Per la realizzazione 
è possibile utilizzare 
PCExplorer light, 
l'apposito kit di 
montaggio, oppure 
una piastra millefori 
per montaggi 
sperimentali. 
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Fig. 6: Ricevitore: lo schema elettrico è molto semplice, 
garanzia di stabilità e affidabilità 
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Fig. 8: Nell'immagine sono visibili le connessioni del rice- 
vitore del radiocomando, realizzato con PCExplorer light 



ponenti elettronici, oppure per corrispondenza 
presso la Elisys s.r.l. {www.pcexplorer.it); i moduli a 
radiofrequenza sono disponibili anche presso la Au- 
rei S.RA. Si consiglia di inserire prima i componenti 
a profilo più basso, iniziando con il circuito integra- 
to e con le resistenze, per poi collegare i condensa- 
tori ed il transistor. Le connessioni possono essere 
realizzate per mezzo di 
spezzoni di filo elettrico 
rigido, seguendo lo sche- 
ma elettrico e le fotogra- 
fie poste a corredo del- 
l'artìcolo. Sul lato sinistro 
dello schema si possono 
notare le connessioni alle 
linee relative alla porta 
seriale e di alimentazio- 
ne dell'apparecchiatura 
PC Explorer light. 



CODICE 

ALLEGATO 

ALLA RIVISTA 

Il codice sorgente della 

applicazione e tutti i 

componenti necessari 

sono reperibili sul CD 

e/o sul Web 

www.ioprogrammo.it 

all'interno del file di 

installazione 

RadiocomandoPC. exe. 



ACQUISTARE PC 

EXPLORER 

LIGHT 

L'apparecchiatura PC 
Explorer light è prodot- 
ta e commercializzata 
dalla Elisys s.r.l. e può 
essere acquistata al 
prezzo di € 213,60 nella 
versione light, € 99 
nella versione basic e € 
69 in kit (IVA inclusa) 
sul web all'indirizzo 
www.pcexplorer.it oppure 
inviando una e-mail 
all'indirizzo 
pcexplorer@elisvs.it, o 
telefonicamente al nu- 
mero 0823/468565 o via 
Fax al: 0823/4954 83 



IL SOFTWARE 

Il software di gestione del radiocomando consente 
di abilitare l'alimentazione del trasmettitore e di 
modulare la trasmissione di un segnale ad onda ret- 
tangolare, che permette l'accensione di un diodo 
LED, anche a diverse centinaia di metri di distanza: 
questo segnale digitale può essere facilmente utiliz- 
zato per azionare svariati tipi di servomeccanismi, 
con l'unico limite della fantasia dell'utilizzatore. Di 
seguito si riporta la classe principale del program- 
ma, semplificata in queste pagine, della quale il let- 
tore potrà trovare una versione completa nei file del 
codice sorgente che il programma di installazione 
provvedere a posizionare nella cartella di installazio- 
ne della applicazione. Sono stati utilizzati due com- 
ponenti sviluppati con Delphi (SpuntoLedCompo- 
nent e SpuntoHyperLabet) che vengono distribuiti 
nel file allegato al CD della rivista in forma compila- 
ta. Chi vuole, può comunque indagarne il funziona- 
mento: nel CD sono disponibili anche in formato 
sorgente. Questi due componenti permettono ri- 
spettivamente la gestione dei componenti che ope- 
rano la simulazione sulla form di un diodo LED e la 
gestione di collegamenti ipertestuali. 




Fig. 9: Lo schema del circuito stampato per la realiz- 
zazione del trasmettitore del radiocomando 



Uses 
Windows, Messages, SysUtils, Variants, Classes, 



Graphics, Controls, Forms, 
Dialogs, ExtCtrls, SpuntoLedComponent, jpeg, 

Buttons, StdCtrls, SpuntoHyperLabel; 
TSpuntoRadicomandoOnOffForm = class(TForm) 

SpuntoHyperLabell: TSpuntoHyperLabel; 

SpuntoHyperLabel2: TSpuntoHyperLabel; 

SpuntoHyperl_abel3: TSpuntoHyperLabel; 

procedure POWERONbuttonClick(Sender: TObject); 

procedure FormCreate(Sender: TObject); 

procedure WritePort(PortAddress, PortData:word); 

// Write PortData over PortAddress if Port Writing ìs 
enabled 

function ReadPort(PortAddress: word): word; 

procedure RadioButtonCOMlClick(Sender: TObject); 

procedure RadioButtonCOM2Click(Sender: TObject); 

procedure ReadAIIPorts; 

procedure TimerlTimer(Sender: TObject); 

//Reads ali COM Ports related to selected serial port 

Procedure ExtractPortArray(PortByte:Word; Var 

PortArray:TPortArray); 

Procedure EncodePortArray(Var Port Byte: Word; 

PortArray:TPortArray); 

procedure DTRSpeedButtonClick(Sender: TObject); 

procedure RTSSpeedButtonClick(Sender: TObject); 

procedure SquareWaveScrollBarChange(Sender: TObject); 

procedure TXSquareWaveSpeedButtonClick(Sender: 
TObject); 

procedure SquareWaveTimerTimer(Sender: TObject); 
private 

{ Private declarations } 
public 

{ Public declarations } 

Com baseAddress : Word ; 

MCRAddress,LCRAddress,MSRAddress:Word; 

MCR,LCR,MSR:TPortArray; 

EnablePortWriting: Boolean; 

RTS,CTS,DSR,CD,DTR,RI:Boolean; 

end; 

Alla creazione della finestra principale viene esegui- 
ta la procedura FormCreate, che imposta i valori di 
default della porta seriale {COMI), le impostazioni 
dei timer e dei pulsanti dell'applicazione. 

procedure TSpunto RadicomandoOnOffForm. 

FormCreate(Sender: TObject); 

begin 

// Port Setup ( COM 1 ) 

EnablePortWriting := True; 

CombaseAddress:=$3f8; 

MCRAddress:=CombaseAddress+4; 

LCRAddress: =CombaseAddress+3; 

MSRAddress:=CombaseAddress+6; 
// Timer Setup 

Ti meri. Enabled : = False; 

Timerl.Interval: = 10; 
// Buttons setup 
ReadAIIPorts; 
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If DTR then DTRSpeedButton.Down:=True else 

DTRSpeedButton. Down : = False; 

If RTS then RTSSpeedButton.Down:=True else 

DTRSpeedButton. Down : = False; 

// Waveform Timer Interval 

SquareWaveTimer.Interval:=SquareWaveScrollBar.Position; 

//Transmission Enable at startup or not? 

SquareWaveTimer.Enabled: = 

TXSquareWaveSpeedButton.Down; 

end; 

La classe TspuntoRadicomandoOnOffForm contie- 
ne al suo interno due componenti non visuali timer, 
SquareWaveTimerTimer e TimerlTimer che svolgo- 
no due compiti fondamentali, provvedendo rispetti- 
vamente a generare la forma d'onda rettangolare 
che viene successivamente trasmessa dal trasmetti- 
tore ed operare l'aggiornamento dello stato di tutti i 
componenti visuali della form. 

procedure TSpuntoRadicomandoOnOffForm. 

SquareWaveTimerTimer( Sender: TObject); 

VAR 

MCRWord:Word; 

begin 

ReadAIIPorts; 

MCR[l]: = Not(RTS); 

if TXSquareWaveSpeedButton.down = False then 

MCR[l]: = False; 

//Codifico MCR in Word e poi lo invio alla porta 

EncodePortArray(MCRWord,MCR); 

WritePort(MCRAddress,MCRWord); 

end; 

Come è già stato detto in precedenza la trasmissio- 
ne del segnale avviene variando lo stato logico del- 
la linea RTS, questa operazione avviene leggendo 
innanzi tutto lo stato della porta seriale, operando 
il NOTlogico della linea RTS e riscrivendo il registro 
MCR {Modem Control Register) della porta. L'inter- 
vallo di esecuzione degli oggetti timer può essere 
agevolmente variato modificando la proprietà In- 
terval dell'oggetto in questione. 

procedure TSpuntoRadicomandoOnOffForm. 

TimerlTimer(Sender: TObject); 

Var 

CurrentY:Integer; 
begin 

ReadAIIPorts; 

If RTS then LedRTS.LedOn else LedRTS.LedOff; 

If CTS then LedCTS.LedOn else LedCTS.LedOff; 

If DSR then LedDSR.LedOn else LedDSR.LedOff; 

IfCD then LedCD.LedOn else LedCD.LedOff; 

If DTR then LedDTR.LedOn else LedDTR.LedOff; 

If RI then LedRI.LedOn else LedRI.LedOff; 

//RF OUT LED 

If RTS then RFOUTSpuntoLed.LedOn else 



RFOUTSpuntoLed.LedOff; 



end; 



L'aggiornamento dello stato logico dei componenti 
visuali avviene in modo abbastanza ovvio impostan- 
do lo stato dei LED (ON oppure OFF) a seconda del 
livello logico delle linee corrispondenti. Alla pressio- 
ne del pulsante Power ON/OFF viene eseguita la pro- 
cedura che segue che provvede ad impostare la linea 
DTR a livello logico HIGH o LOW a seconda che 
pulsante sia premuto o meno, alimentando o spe- 
gnendo in questo modo il circuito trasmettitore. 




H 

o 


o 


o 






R2 




RI 



• 









Fig. IO: In figura è visibile la distribuzione dei componenti sul circuito stampato del 
trasmettitore 



procedure TSpuntoRadicomandoOnOffForm. 

POWERONbuttonClick(Sender: TObject); 

VAR 

MCRWord:Word; 

begin 

SquareWaveTimer.Enabled: = (POWERONbutton.Down 

and TXSquareWaveSpeedButton.Down); 

Timerl.Enabled:=POWERONbutton.Down; 

ReadAIIPorts; 

If DTR then DTRSpeedButton. Down:=True else 

DTRSpeedButton. Down: =False; 
If RTS then RTSSpeedButton.Down:=True else 

RTSSpeedButton.Down:=False; 

ReadAIIPorts; 

MCR[0]: = POWERONbutton.Down; //Power ON/OFF DTR line 
if TXSquareWaveSpeedButton.down = False then 

MCR[l]: = False; // RTS Line 

//Codifico MCR in Word e poi lo invio alla porta 

EncodePortArray(MCRWord,MCR); 

WritePort(MCRAddress,MCRWord); 

end; 

Il programma permette di modificare manualmente 
lo stato logico delle linee DTR ed RTS della porta se- 
riale, per mezzo delle due procedure che seguono, al 
momento della pressione del rispettivo pulsante. 



PRECAUZIONI 

Prima di collegare il 
circuito al PC occorre 
verificare la nostra 
realizzazione con 
attenzione per 
assicurarci che tutto sia 
stato collegato come 
previsto. 



procedure 


TSpuntoRadicomandoO 
DTRSpeedButtonCI 


lOffForm. 
ck(Sender: 


TObj 


3ct); 


VAR 


MCRWord 


Word; 
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begin 

ReadAIIPorts; 

MCR[Q]: = DTRSpeedButton.Down; 

//Codifico MCR in Word e poi lo invio alla porta 

EncodePortArray(MCRWord,MCR); 

WritePort(MCRAddress,MCRWord); 

end; 

La procedura che segue, eseguita non appena si pre- 
me pulsante RTS, ha la caratteristica di consentire 
il controllo manuale dello stato logico del segnale 
trasmesso, agendo direttamente sulla linea fìsica 
corrispondente della porta seriale. 

procedure TSpuntoRadicomandoOnOffForm. 

RTSSpeedButtonClick(Sender: TObject); 

VAR 

MCRWord:Word; 

begin 

ReadAIIPorts; 

MCR[l]: = RTSSpeedButton.Down; 

//Codifico MCR in Word e poi lo invio alla porta 

EncodePortArray(MCRWord,MCR); 

WritePort(MCRAddress,MCRWord); 

end; 

È possibile variare la frequenza di modulazione del- 
la portante, variando la scrollbar relativa: facendo 
ciò la procedura che segue modifica l'intervallo 
temporale di azionamento del timer SquareWaveTi- 
mer, modificando di conseguenza la forma d'onda 
trasmessa. 

procedure TSpuntoRadicomandoOnOffForm. 

SquareWaveScrollBarChange(Sender: TObject); 
begin 

SquareWaveTimer.Interval:=SquareWaveScrollBar.Position; 
end; 



ESECUZIONE 
SU WINDOWS 

L'installazione e l'esecuzione del programma non 
creano difficoltà, il software viene fornito anche nel- 
la versione completamente compilata e collaudata. 
Il file eseguibile di installazione provvede automati- 
camente a predisporre la creazione di un'unica car- 
tella configurabile dall'utente, all'interno della quale 
vengono copiati tutti i file necessari all'utilizzazione 
del software. 

Al termine dell'installazione saranno disponibili i 
collegamenti alle versioni del programma per Win 
9.X /Me, chiamato "Radiocomando PC", nonché alla 
versione per Win XP/NT/ 2000, denominato "Radio- 
comando PC XP NT", oltre che ai collegamenti agli 
schemi elettrici della realizzazione. Durante l'esecu- 
zione del programma, tutti i comandi sono disponi- 



bili in un'unica form: partendo dall'alto notiamo i 
radio buttons deputati alla selezione della porta 
seriale alla quale è collegata il circuito elettronico, 
con i relativi indirizzi di default per COMI e COM2. 
Nel caso in cui i parametri non coincidano con quel- 
li del computer che si sta utilizzando, il lettore non 
avrà difficoltà di modificarne il valore nelle proce- 
dure RadioButtonCOMl click e RadioButtonCOM2 
click. I due pulsanti presenti sul lato sinistro della 
form provvedono rispettivamente ad alimentare il 
circuito trasmettitore [Master Power ON /OFF} e ad 
azionare la trasmissione del segnale digitale (Canale 
1 ON/OFF). La frequenza di trasmissione del segnale 
può essere variata modificando la posizione della 
scrollbar posta in basso alla finestra. L'utilizzo del 
programma su sistemi dotati di Win 2000, XP oppu- 
re NT viene reso possibile dal programma di instal- 
lazione per mezzo delle opportune predisposizioni: 
occorre tenere presente che per potere operare l'in- 
stallazione su queste macchine occorre disporre dei 
relativi privilegi di sistema. 

Poiché il software accede direttamente all'hardware 
della macchina, viene installato il driver "PortTalk - 
A Windows NT/2000/XP I/O Port Device Driver Ver- 
sion 2.2" che può essere anche scaricato dal sito: 
'www.beyondlogic.org/porttalk/porttalk.htm'. Il file 
'Porttalk22.zip' contiene tutte le istruzioni necessa- 
rie all'utilizzo corretto del driver, nonché una note- 
vole mole di informazioni relative all'accesso delle 
porte hardware del PC: viene fornito inoltre codice 
sorgente completo delle applicazioni. 
Per quanto riguarda l'utilizzo del programma pro- 
posto in questa sede sotto Win 2000/NT/XP vengo- 
no estratti i file contenenti il driver Porttalk nella 
directory del programma da utilizzare e viene copia- 
to il file porttalk .sys nella directory di sistema. Per 
consentire l'esecuzione del programma viene chia- 
mata l'applicazione Radiocom.exe per mezzo del 
comando inserito nel file batch Radiocomando- 
XP.bat: Allowio Radiocom.exe la che consente l'ac- 
cesso da parte dell'eseguibile Radiocom.exe a tutte 
le porte del PC. 



CONCLUSIONI 

Nel prossimo appuntamento introdurremo le prime 
applicazioni reali di questo progetto. Un doveroso e 
sentito ringraziamento è dovuto alla AUREL S.pA. 
per la cortese autorizzazione alla pubblicazione del- 
la documentazione relativa ai moduli TX-SAW 433/s- 
Z 434 e RX-4M50RR30SF. Il lettore vorrà comprende- 
re che nonostante quanto esposto in queste pagine 
sia stato debitamente verificato e collaudato, tutta- 
via viene riportato a scopo illustrativo e di studio, 
pertanto l'editore e l'autore non sono da considera- 
re responsabili per ogni eventuale consegunzza. 

Luca Spuntoni 



* 72 /Novembre 2004 



http://www.ioprogrammo.it 



Internet dinamico H T PALMARI 



Siti WEB facilmente aggiornabili e visibili su cellulari i-mode 

Creare siti per i-mode 

parte seconda 

In questa seconda parte porteremo a termine la progettazione di un sito 
aggionabile e gestibile in remoto. Realizzeremo pagine i-mode 
compatibili per rendere disponibili i servizi del sito anche via cellulare 



Nello scorso numero abbiamo analizzato le 
problematiche relative alla gestione di un 
sito da remoto: abbiamo realizzato pagine 
ASP accessibili solo all'amministratore e predispo- 
sto l'interfaccia utente-studente. Abbiamo anche 
visto come utilizzare componenti software per l'in- 
vio di e-mail da pagine ASP. In questa seconda parte 
completeremo la costruzione del sito creando pagi- 
ne per l'interfaccia utente-docente e realizzeremo 
una sezione per offrire agli utenti-studenti servizi 
fruibili anche da cellulari dotati di tecnologia i- 
mode. 



INSERIMENTO 
ARTICOLI 

Ogni docente può inviare al server i suoi articoli. 
Questi saranno inclusi nel database e consultabili 
dagli studenti. Per inserire i dati, il docente utilizza il 
form InserìmentoArticoli.asp: deve specificare anche 
il nome del file di testo (deve contenere solo testo, 
senza marcatori HTML) che contiene l'articolo e di 
cui sarà eseguito l'UpLoad. Ci viene in aiuto di nuo- 
vo il componente Persits: diamo uno sguardo al file 
Esegui_Inserimento_Articoli.asp. 

application. Lock 

set Upload = Server.CreateObject("Persits.Upload") 
p_count = Upload. Save("c:\inetpub\ 

wwwroot\ifp\docenti\articoli\temp") 
p_codiceCorso=Cstr(Upload.form("p_codiceCorso")) 

p file= Cstr( Upload. form("p_file")) 

p_username= Cstr(Upload.form("p_username")) 
p_password= Cstr(Upload.form("p_password")) 
p_TitoloArticolo= Cstr(Upload.form("p_TitoloArticolo")) 

p_subfileName= Upload. Files(l).Path 

p_subfileNamel = replace(p_subfileName,"c: 

\inetpub\wwwroot\ifp\docenti\articoli\temp\", "") 
set Upload=Nothing 

Si crea una istanza dell'oggetto Persits. Upload e si 
carica il file con il metodo Upload.Save, specifican- 



do la cartella in cui salvarlo. Prima di eseguire l'u- 
pload, si blocca l'applicazione per evitare che due 
utenti carichino contemporaneamente due file con 
lo stesso nome. Il file viene salvato in una cartella 
temporanea per poi essere spostato, a fine elabora- 
zione, nella cartella Articoli. Viene controllato che 
nella cartella articoli non esista già un file con quel 
nome e se sì si avvisa l'utente con un messaggio e si 
provvede a cancellare i file creati: 

'verifica se il file caricato esiste già 
set FileObject=Server.CreateObject( 

"Scripting.FileSystemObject") 
p_FileEsistente= "c:\inetpub\wwwroot\ifp\docenti 

\articoli\" & p_subfilel\lamel 
if FileObject.fileExists(p_FileEsistente) then 
' il file esiste e contiene un altro articolo. Devi 

scegliere un altro nome 
p_err=l 

FileObject.DeleteFile(p_subfileName) 

set FileObject=nothing 

Se il nome del file non è presente tra gli articoli pub- 
blicati, si procede alla creazione della pagina asp che 
conterrà il testo dell'articolo, comprese le intestazio- 
ni, e si sposta il file nella cartella articoli. Il nome 
della pagina asp sarà uguale al nome del file di testo. 

'sposta il file di testo nella cartella Articoli 

FileObject.MoveFile p_subfileName,p_FileEsistente 

set FileObject=nothing 

'crea il file asp che conterrà I articolo 

p_NomeFile=p_subfileNamel 

p_NomeFile=replace(p_NomeFile,".txt",".asp") 

set NewFileObject=Server.CreateObject( 

"Scripting.FileSystemObject") 
set NewFile= newFileObject.CreateTextFile("c:\inetpub\ 
wwwroot\ifp\docenti\articoli\" & p_NomeFile) 
newFile.WriteLine("<!--#include virtual = " & chr(34) 

& "ifp/indexRiga.txt" & chr(34) & "-->") 

newFile.WriteLine("<prexb>" & p_TitoloArticolo 

& "</bxbrxbr>") 
newFile.WriteLine("<!--#include virtual = " & chr(34) & 




^CD El WEB 

IFRzip 
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"ifp/docenti/articoli/" & p_subfileNamel & chr(34) <%end if 

& "-->") next 

newFile.WriteLine("</pre></body></html>") tableSet.MoveNext 

newFile.close wend 



Infine vengono salvate tutte le informazioni nella 
tabella Artìcoli, utilizzando in metodo AddNew del- 
l'oggetto RecordSet. 



CANCELLAZIONE 
ARTICOLI 

Il docente può anche eliminare un suo articolo. 
Questo sarà rimosso dalla tabella Artìcoli, ma i file 
contenenti il testo (sia il file di testo che i files asp) 
saranno spostati nella cartella \ifp\cestino e vi reste- 
ranno finché l'amministratore non svuoterà il cesti- 
no. Prima di accedere alla selezione degli articoli da 
cancellare, saranno richieste nuovamente Userna- 
me e Password del docente dal form contenuto nella 
pagina CancellaFormArticoli.asp. Accertati i dati, 
verranno elencati tutti gli articoli pubblicati dal do- 
cente (pagina Esegui_FormArtìcoli.asp). 

SELECT Articoli. IDarticolo, Articoli. CodiceCorso, 

Articoli. TitoloArticolo, Articoli. Data Pubblicazione, 

Articoli. IndirizzoFile FROM Docenti INNER JOIN Articoli 

ON Docenti. IDdocente = Articoli. IDdocente GROUP BY 

Articoli. IDarticolo, Articoli. CodiceCorso, 

Articoli. TitoloArticolo, Articoli. Data Pubblicazione, 

Articoli. IndirizzoFile, Docenti. UserNa me, 

Docenti. Password HAVING (((Docenti. Userl\lame) = 

'" & p_username & "') AND ((Docenti. Password) = 

'" & p_password & '")) ORDER BY 

Articoli. DataPubblicazione DESC 

Con questa interrogazione Sql si estraggono tutti gli 
articoli del docente (vedi la clausola Having) in ordi- 
ne decrescente di data di pubblicazione. Vengono 
poi elencati tutti gli articoli in una tabella contenen- 
te nel primo campo un checkbox che ha la stessa 
funzione di quello usato nella pagina per la modifi- 
ca/cancellazione dei corsi (se selezionato assume 
come valore Y IDarticolo) 

<% While not tableSet.EOF %> 

<trxTR><TD> 

<INPUT TYPE = "checkbox" l\IAME="p_delete" 

VALUE="<%=tableSet.Fields(Q).value%>"> 

</TD> 

<%for x = 1 to (p_numerOfColumns-l) 

if x=4 then %> 

<Td> <a href=<%=Server.URLEncode(Cstr( 

tableSet.Fields(4).value))%>> 

<%=Cstr(tableSet.Fields(4).value )%></ax/Td> 

<%else%> 

<Td> <%=tableSet.Fields(x).value %></Td> 



Tramite i checkbox è possibile selezionare gli artico- 
li da cancellare e cliccando sul tasto del form 
Cancella, gli articoli selezionati si passa alla pagina 
Esegui_Esegui_CancellaFormArticoli.asp. La prima 
operazione da fare è determinare quanti record de- 
vono essere cancellati 

NumeroRecordCancellare=Request.Form("p_delete").Count 

Il ciclo successivo cancella i record degli articoli 
dalla tabella Articoli e tutti i file relativi ad essi (li spo- 
sta nella cartella Cestino): 

for p_cancella = l to NumeroRecordCancellare 
p_ID_DaCancellare=Request.form("p_delete").item( 

p_cancella) 
deleteSet.Open "select * from Articoli where 

IDarticolo= " &_ p_ID_DaCancellare,IFPDB, 
adOpenDynamic, adLockPessimistic, adCmdText 

if not deleteSet.EOF then 

p_IndirizzoFile= "c:\inetpub\wwwroot\ifp\docenti\ 

articoliV &_ deleteSet("IndirizzoFile") 
p_fileName= "c:\inetpub\wwwroot\ifp\docenti\articoli\" 

& _ deleteSet("NomeFile") 

p_fileNameImode= "c:\inetpub\wwwroot\ifp\docenti\ 

articoliV &_ deleteSet("IndirizzoFileImode") 
p_IndirizzoFileCestino= "c:\inetpub\wwwroot\ifp\ 

cestino\" &_ deleteSet("IndirizzoFile") 
p_fileNameCestino= "c:\inetpub\wwwroot\ifp\cestino\" 

& _ deleteSet("NomeFile") 

p_fileNameImodeCestino= "c:\inetpub\wwwroot\ifp\ 

cestino\" & _ deleteSet("IndirizzoFileImode") 
fileDaSpostare.MoveFile p_IndirizzoFile, 

p_IndirizzoFileCestino 
fileDaSpostare.MoveFile p_filel\lame,p_fileNameCestino 
fileDaSpostare.MoveFile p_fileNameImode, 

p_filel\lameImodeCestino 
deleteSet. delete 

deleteSet.UpDate 

end if 

deleteSet. Close 
next 



INVIO 
COMUNICAZIONI 

Dal form InserimentoComunicazioni si inseriscono 
tutti i dati relativi alla comunicazione da inviare agli 
studenti, compreso il nome del file di testo conte- 
nente il messaggio. La pagina asp Esegui Jnserimen- 
toComunicazione utilizza entrambi i componenti 
Persits: AspUpload e AspEmail. Per l'upload il proce- 
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dimento è molto simile a quello utilizzato nell'inse- 
rimento di articoli: l'applicazione viene bloccata per 
evitare che due utenti diversi carichino sul server 
due file con lo stesso nome; il file di testo viene sal- 
vato nella cartella \ifp\docenti\articoli\temp e dopo 
l'invio della e-mail, viene cancellato. 
Prima di inviare il messaggio, viene creata una strin- 
ga contenente tutti gli indirizzi degli studenti iscritti 
al corso oggetto della comunicazione. 



PASSIAMO 
ALLA PRATICA 

L'Istituto di Formazione professionale vuole creare 
dei sevizi anche per gli studenti che posseggono un 
cellulare i-mode. I servizi previsti sono: consultazio- 
ne dei corsi attivati (area accessibile a tutti), visione 
degli articoli, prenotazione esami (questi ultimi due 
solo per gli studenti registrati). 




'estrai gli indirizzi dei destinatari 
sqlIndirizzi="SELECT Studenti. email, Studentilscritti. 

CodiceCorso FROM Studenti INNER JOIN Studentilscritti 
ON Studenti. IDstudente = Studentilscritti. 
IDstudentelscritto WHERE (((Studentilscritti. 
CodiceCorso)= '" & p_codiceCorso & "'))" 
set userSetIndirizzi=IFPDB.Execute(sqlIndirizzi) 
'prepara la lista di indirizzi 
p_indirizzo="" 

while (not userSetlndirizzi.EOF) 
p_Indirizzo=p_indirizzo & trim( 

userSetIndirizzi.fields.item("email")) & "," & " " 
userSetlndirizzi.MoveNext 
wend 
set userSetIndirizzi = nothing 



IL SERVIZIO I-MODE 

i-mode è un servizio che permette di accedere ad 
Internet dal cellulare. Questa nuova tecnologia è 
stata lanciata in Giappone dalla NTT DoCoMo, che 
detiene tuttora marchio. In Italia la prima compa- 
gnia telefonica ad introdurre servizi i-mode è stata 
Wind. La connessione i-mode è sempre attiva e il co- 
sto dipende (sarebbe più corretto dire dipenderà, 
dal momento che attualmente sono ancora in vigo- 
re le offerte promozionali) dai KB scambiati. Un cel- 
lulare dotato di servizi i-mode è in grado di interpre- 
tare il cHTLM (Compact HTLM), una versione com- 
patta del linguaggio HTML. E' possibile leggere le 
specifiche dello standard cHTML del World Wide 
Web Corsortium (W3C) all'indirizzo www.w3.org/TR 
/1998/NOTE-CompactHTML-19980209. La DoCoMo, 
inoltre, ha messo a disposizione gratuitamente una 
guida in pdf all'indirizzo www.imode.nl/imode/gpc 
lattachments/How%20to%20create%20an%20i- 
mode%20site.pdf Dal cHTML sono escluse alcune 
funzioni: mappe di immagini, immagini JPEG, ta- 
belle, frame, fogli di stile, immagini di sfondo; si di- 
spone in una pagina di un solo font e un solo stile. 
Sono state introdotte le accesskey: è possibile asso- 
ciare un numero ad un link e selezionarlo da tastie- 
ra premendo il tasto corrispondente. 
Ultimo particolare: una pagina cHTML può essere 
visualizzata sul computer da un qualsiasi browser e 
può essere ospitata su un comune host adibito ad 
ospitare siti WEB. 



La homepage per i-mode 

Analizziamo il contenuto della pagina imodejn- 
dex.asp. 

<%@ LANGUAGE = "VBSCRIPT" %> 

<!DOCTYPE HTML PUBLIC -//W3C 

//DTP Compact HTML 1.0 Draft//EN> 

<HTML> <head> 

<TITLE>Istituto di formazione professionale. 

Servizio i-mode</TITLE> 
<meta http-equiv="content-type" content= 

"text/html;charset=x-sjis"> 
<meta name = "CHTML" content="yes"> 

</head> 

<BODY TEXT="#000000" BGCOLOR="99CCFF"> 

<CENTER>Istituto di formazione professionale. 

Servizio <I>i</I>-mode home 

</CENTER> 

<hr noshade size="l"> 

<marquee behavior="scroll" direction = "left" 

width = "150" loop="16"> 
Istituto di formazione professionale - servizio i-mode 
</marquee> 
<hr noshade size="l"> 
<a accesskey="l" href="http://localhost/ifp/corsi 

/imode_IndiceCorsi.asp">驪</a> 
Indice corsi<br /> 
<a accesskey="2" href="http://localhost/ifp/docenti 

/Articoli/imode_FormArticoli.asp">麗</a> 

Indice Articoli<br /> 

<a accesskey="3" href="http://localhost/ifp/studenti/ 

imode_FormPrenotazioni.asp">黎</a> 

Prenotazione Esame<br/> 

<a accesskey="4" href=mailto:xxxx.yyyyy@tiscali.it> 

[4]</a>Scrivi<br /> 
<a accesskey="5" href=tel:+39123456>[5]</a> 

Telefona<br /> 
<hr noshade size="l"> </body> 
</html> 

Naturalmente, contenuto della pagina deve essere 
ridotto all'osso. Rispetto all'HTML le uniche diffe- 
renze che si notano sono le AccessKey, che permet- 
tono di selezionare il collegamento premendo il 
tasto corrispondente, e la possibilità di comporre un 
numero di telefono attraverso un link. Il codice 
#63879 farà apparire il numerino 1 incassato in un 
quadratino bianco in corrispondenza del link Indice 




www.w3.orq/TR/1 998/ 
NOTE-CompactHTML- 
19980209 
specifiche dello 
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guida in pdf su come 

costruire siti i-mode 

compatibili 



girv'Ti] 




Fig. 1: II menu principa- 
le del servizio 



http://www.ioprogrammo.it 



Novembre 2004/75 ► 



PALMARI T H Nuove tecnologie Microsoft 





Chi non possiede un 

telefono cellulare 

dotato di servizio 

i-mode, può testare la 

propria pagina cHTML 

con un simulatore 

online consultabile 

liberamente 

all'indirizzo 

www, wapag.com/en/ 

simulation-check 




Sul sito sono 

disponibili per il test 

diversi modelli di 

cellulari. 



corsi (così per il 2 e il 3); per i link con accesskey 
uguale a 4 e 5 viene semplicemente visualizzato il 
numerino racchiuso tra parentesi quadre. Con il link 
4 richiama il programma di gestione della posta per 
inviare e-mail all'indirizzo specificato. Con il link 5 è 
possibile invece comporre il numero di telefono in- 
dicato e inoltrare la chiamata. Questa funzione non 
poteva mancare dato che abbiamo a che fare con dei 
telefoni cellulari! Chi non possiede un cellulare do- 
tato di servizio i-mode, può testare la propria pagina 
cHTML con un simulatore online consultabile libe- 
ramente all'indirizzo www.wapag.com/enlsimula- 
tion-check. Se si possiede US o PWS (sono comun- 
que indispensabili per testare le pagine asp) non è 
necessario pubblicare preventivamente la propria 
pagina. Basta avviare il programma di Server Web e 
sostituire a localhost il proprio indirizzo IP. Per 
esempio se il proprio IP è 62.10.53.41 si dovrà inseri- 
re nel simulatore l'indirizzo completo: http://62.10. 
53.41/ifp/imode_index.asp. 

Form di prenotazione esami e consultazione 
articoli 

I due form sono identici e richiedono l'inserimento 
di Username e Password: 



<form action 


="Imode_Prenotazioni.asp' 


method= 


'post"> 


Username: 


<input type= 


'text' 


name 


="p_username"> 
<br/> 


Password: 


<ìnput type= 


'password" name="p_ 

password"xbr /> 


<input type="submit" ve 


lue= 


'Entra 


> 




</form> 



Anche le pagine collegate a questi due form sono 
molto simili ed elencano i corsi a cui uno studente è 
iscritto. Ricordiamoci che i tag <table> non sono 
consentiti 

set IFPDB=Server.CreateObject("ADODB. Connection") 

IFPDB.Open "IstitutoIFP" 

set tableSet=Server.CreateObject("ADODB.Recordset") 
tableSet.Open "SELECT Studenti. IDstudente, 

Studenti. UserName, Studentilscritti.IDcorso, 

Studentilscritti.CodiceCorso, Corsi. Data Esame FROM Corsi 

INNER JOIN (Studenti INNER JOIN Studentilscritti ON 

Studenti. IDstudente = Studentilscritti. IDstudentelscritto) 

ON Corsi. IDcorso = Studentilscritti.IDcorso WHERE 

(((Studenti. IDstudente) = 

" & p_IDutente & "))", IFPDB %> 

Corsi ai quali sei iscritto 
<hr noshade size="l"> 

<P> 

<% While not tableSet.EOF %> 

Corso <A HREF="Imode_Esegui_FormPrenotazioni.asp? 

p_CodiceCorso=<%Response.Write tableSet( 

"CodiceCorso")%>;p_IDutente=<%Response.Write 

tableSet("IDstudente")%>"> 



<%=tableSet.Fields(3).value%x/A> 

Data Esame <%=Cdate(tableSet.Fields( 

"DataEsame").value)%> 

<br/><% tableSet.MoveNext 

wend 

Nelle pagine i-mode non sono stati utilizzati dei 
cookies. I parametri passano attraverso i collega- 
menti, pertanto bisogna evitare di trasmettere infor- 
mazioni riservate come Username e Password; per 
identificare lo studente è stato passato come para- 
metro il suo ID. Per la prenotazione la procedura è 
del tutto simile a quella utilizzata in precedenza. 
Per gli articoli, viene visualizzato l'elenco di quelli 
relativi al corso selezionato: 

Indice Articoli del corso <%=p_CodiceCorso%xbrxbr> 

<% While not tableSet.EOF ' titolo %> 

<a href=<%=Server.URLEncode(Cstr( 

tableSet.Fields(6).value))%>> 

<%=Cstr(tableSet.Fields(3).value )%x/axbr /> 

<% tableSet.MoveNext 

wend 

Dalla tabella Articoli si preleva l'indirizzo del file for- 
mattato per Fi-mode e cui percorso era stato salva- 
to in un campo della tabella al momento dell'inseri- 
mento. Questo sarà il contenuto tipico di un file con- 
tenente un articolo formattato: 



<! 


-#include 


virtual = 


'ifp/ImodeTop.txt"- 


-> 




<b 


>Articolo 


su Imode</bxbr /> 






<! 


-#include 


virtual = 


'ifp/docenti/articoli 

/Articololmode 


.txt"-> 


<! 


-#include 


virtual = 


'ifp/ImodeTop.txt"- 


-> 





mentre il contenuto del file ImodeTop.txt contiene la 
solita intestazione e un'immagine gif collegata alla 
HomePage 

<IMG SRC= "http ://localhost/ifp/images/home. gif" 

HEIGHT=26 WIDTH = 26 BORDER=0> 

</A>Istituto di formazione professionale. 

Servizio <I>i</I>-mode Indice Articoli 



CONCLUSIONI 

Data la scarsa quantità di memoria dei telefoni 
cellulari e dal momento che chi naviga con i-mode 
paga in base ai KB scambiati, sarà bene progettare 
le pagine in modo tale che non superino i 5 KB, 
limitando le immagini e concentrando i contenu- 
ti. I nostri siti perderanno in "immagine", ma l'o- 
biettivo in questo caso è quello di rendere dei ser- 
vizi che possano essere utilizzati in modo profi- 
cuo. 

Patrizia Martemucci 
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Web Service Enhancements 2.0 



Instant Messenger 

con WSE 2 

In casa Microsoft è in atto un'evoluzione verso una nuova 
piattaforma denominata Indigo. Ma tra i WS attuali e Indigo 
c'è WSE 2: scopriamo come utilizzarlo e con quali vantaggi 



Far comunicare sistemi diversi, piattaforme di- 
verse (magari distanti fisicamente), è stata 
una delle maggiori problematiche risolte dai 
servizi web. Un servizio Web altro non è che una 
porzione di codice eseguibile, dotato di una inter- 
faccia standardizzata che lo rende accessibile via 
Web, tramite protocollo HTTP. In .NET, un Web Ser- 
vice ha la necessità di un web server. Seppur abba- 
stanza nuova, questa tecnologia ha subito mostrato 
alcuni limiti. Primo tra tutti il protocollo di comuni- 
cazione. Sebbene HTTP sia estremamente diffuso, 
non sempre è l'ideale per la risoluzione di alcune 
problematiche. HTTP infatti si basa su un meccani- 
smo di richiesta/risposta: il client invia una richiesta 
e resta in attesa di una risposta. Questa caratteristica 
lo rende inappropriato, ad esempio, in situazioni in 
cui si necessita di una comunicazione punto-punto 
o ancora in situazioni in cui ad una richiesta cor- 
rispondono risposte multiple. I Web Service Enhan- 
cements (WSE), ormai giunte alla seconda versione, 
alcune lacune dei servizi web tradizionali. Primo tra 
tutti il protocollo di comunicazione non più vincola- 
to all'HTTR La prima importante conseguenza di 
questa modifica è che, utilizzando WSE 2, non c'è 



Invia a: 5oap.tcp://localho5t:9001/IM 



E 



Ciao, come va? 

>A me bene. E a te? 



A| 



V| 



In Ascolto su: soap.tcp://localhost:900Q/IM 



In Ascolto H 



In ascolto su soaptcp:/71ocalhost:9{H}D/IM 



Fig. 1: L instant messenger che realizzeremo 



più la necessità di avere un server WEB che fornisca 
il servizio. Possiamo quindi realizzare applicazioni 
che scambiano messaggi direttamente da un punto 
all'altro di una rete senza che ci sia un intermediario. 
Questo è esattamente quello che vedremo in questo 
articolo. Un altro vantaggio molto importante di 
questa modifica è che cade anche il vincolo intrinse- 
co del protocollo HTTP: richiesta/risposta. Vedremo 
infatti che WSE ci consente di creare dei messaggi 
SOAP la cui risposta è magari indirizzata ad altri de- 
stinatari, e non a chi ha fatto la richiesta specifica. 



WSE 2.0 

Web Service Enhancements, in sostanza, cosa è? Cito 
dalla documentazione ufficiale: WSE è un motore 
per applicare avanzati protocolli per servizi wse ai 
messaggi SOAP Questo potrebbe anche richiedere la 
trasformazione del corpo del messaggio SOAP È be- 
ne chiarire subito che, come evidente nella frase 
appena citata, WSE non è qualcosa di molto diverso 
dai servizi Web tradizionali, ma un loro potenzia- 
mento. Quello che abbiamo già imparato sui servizi 
Web resta sostanzialmente valido. Alla base c'è sem- 
pre un messaggio SOAP che viaggia, c'è sempre un 
mezzo di comunicazione che lo fa viaggiare (il pro- 
tocollo) e l'esigenza di base è sempre la stessa: far 
comunicare dei sistemi. WSE estende i servizi web 
tradizionali portandoli in un'ottica SOA (Service 
OrientedArchitecture). Le maggiori novità apportate 
da WSE sono: 

• Sicurezza: l'unico modo per rendere sicuri dei 
tradizionali servizi Web è quello di usare SSL. 
WSE invece implementa le specifiche WS-Secu- 
rity. Tali specifiche sanciscono il modo in cui ga- 
rantire che un messaggio SOAP sia integro 
(quindi non sia stato compromesso durante il 
trasporto), sia confidenziale e, soprattutto, sia 
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APPROFONDIMENTI 



Il punto di partenza 

per approfondire 

l'argomento è 

http://msdn.microsoft,com 

/webservices/ . 

Oltre ai tradizionali 

servizi web, ci sono 

tutte le informazioni 

relative a WSE 



Output 

Pipeline 



Pipeline 



Fig. 2: Schema 
dell'architettura WSE 



autentico. Immaginate cosa potrebbe succedere 
se un nostro messaggio che rappresenta un ordi- 
ne venisse intercettato e magari modificato! WS- 
Security fornisce inoltre il meccanismo che con- 
sente di associare le credenziali direttamente nel 
messaggio, magari cifrandole. 

Allegati: la specifica WS-Attachments descrive il 
modo in cui poter inserire degli allegati non se- 
rializzati in XML, nel messaggio SOAP 

Routing: il routing di un messaggio SOAP consi- 
ste, in breve, nella possibilità di trasferire un 
messaggio SOAP da un punto ad un altro, attra- 
verso diversi intermediari. I meccanismi per po- 
ter implementare il routing dei messaggi sono 
definite nelle specifiche WS-Routing. 

SOAP Messaging: è forse la parte chiave di tutta 
l'architettura WSE. In definitiva, fornisce tutte le 
funzionalità che consentono l'invio del messag- 
gio SOAP utilizzando protocolli diversi dal- 
l'HTTP nonché la possibilità di gestire l'invio 
punto - punto ecc. 



ANATOMIA DI 

UHI MESSAGGIO SOAP 

Dopo questo accenno abbastanza generale ed intro- 
duttivo a WSE 2.0, muniamoci dell'occorrente e ini- 
ziamo a lavorare. Per farlo, dobbiamo innanzitutto 
scaricare WSE 2.0 dal sito Microsoft (vedi box latera- 
le) ed installarlo. L'operazione richiede pochi minuti 
e non necessita del riavvio del sistema. Completata 
l'installazione di WSE 2.0, iniziamo immediatamen- 
te a sperimentare qualcosa, magari "guardando" 
direttamente un messaggio SOAP. Apriamo quindi 
Visual Studio .NET 2003 e creiamo un nuovo proget- 
to (WindowsForm) scegliendo come linguaggio C#; 
diamo quindi al progetto il nome InstantMessenger. 
Oltre a creare il nostro progetto, Visual Studio creerà 
per noi anche la soluzione (chiamata anch'essa In- 
stantMessenger) in cui andremo ad inserire gli altri 
nostri progetti. Abbandoniamo per un po' il pro- 
getto Windows Form e creiamo un nuovo progetto. 
Questa volta scegliamo Applicazione Console che 
chiameremo SoapMessage. Per prima cosa, aggiun- 
giamo un riferimento a WSE cliccando con il tasto 
destro del mouse sulla cartella References, selezio- 
nando la voce Aggiungi riferimento e selezionando 
dall'elenco Microsoft.Web.Service2.dll. Con le diretti- 
ve using, predisponiamoci a lavorare conWSE2: 

using Microsoft. Web. Services2; 

using Microsoft. Web. Services2.Addressing; 



mento è quello di vedere in chiaro il nostro messag- 
gio SOAP Nel metodo Main del nostro progetto, ini- 
ziamo a costruire un messaggio di esempio: 

[STAThread] 

static void Main(string[] args){ 

SoapEnvelope messaggio = new SoapEnvelope(); 
messaggio. CreateBody(); 
messaggio. Body. AppendChild( 

messaggio. CreateElement("Nodol")); 
messaggio. Body. FirstChild.AppendChild( 

messaggio. CreateTextNode("Valorel")); 
messaggio. Body. AppendChild( 

messaggio. CreateElement("Nodo2")); 
messaggio. Body.ChildNodes[l].AppendChild( 

messaggio. CreateTextNode("Valore2")); 

SoapEnvelope è la nostra "busta", quella che conter- 
rà l'intero messaggio. Questa classe deriva da XML- 
Document, quindi il nostro messaggio può essere 
costruito come se fosse un normale file XML (pro- 
prio come nell'esempio). In alternativa, possiamo 
lasciare al SoapEnvelope il compito di creare il body 
del messaggio passandogli direttamente un oggetto. 
SoapEnvelope infatti implementa il motore di seria- 
lizzazione XML che serializzarà per noi l'oggetto 
passato e creerà il body del messaggio: 

messaggio. SetBodyObject(mioOggetto); 

Questo sarà indubbiamente il sistema maggiormen- 
te utilizzato, ma ora ci interessa capire cosa fa esat- 
tamente l'Envelope. Una volta creato il corpo mes- 
saggio, inseriamo le informazioni sul recapito dello 
stesso: 

messaggio. Context.Addressing. Action = new Action( 

"urn:ProvaSoapMessage"); 

messaggio. Context.Addressing. From = new From(new 
EndpointReference(new Uri("soap.tcp: //ioProgrammo: 

9000/ProvaSOAP"))); 

messaggio. Context.Addressing. To = new To(new Uri 

("soap.tcp://iPprogrammo:9001/ProvaSOAP")); 

Per prima cosa, dichiariamo uva. Action per il nostro 
messaggio. Aggiungiamo poi le informazioni sul re- 
capito vero e proprio (Ufivm ed il to). A questo pun- 
to il nostro messaggio è pronto per essere inviato 
con l'istruzione: 

SoapSender ss = new SoapSender(new Uri( )); 

ss. Send( messaggio); 

Ma quello che ci interessa vedere è il contenuto del 
messaggio, una volta che è stato processato dalla 
Pipeline (vedi Fig. 2). Procediamo al processing: 



Lo scopo che ci prefiggiamo in questo primo esperi- Pipeline pi = new PipelineQ; 
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pl.ProcessOutputMessage(messaggio); 

e al salvataggio del messaggio stesso direttamente 
sull'hard disk: 

messaggio. Sa ve(Environment. Cu rrentDirectory+ 

"Wmessaggio.xml"); 

Una volta eseguito il codice, nella cartella di esecu- 
zione del programma ci troveremo un nuovo file 
XML che conterrà il nostro messaggio. Come visibi- 
le dall'immagine in Fig. 3, il messaggio è costituito 
da un XML contenente sia le informazioni relative al 
body che abbiamo realizzato manualmente, sia le 
informazioni aggiuntive relative all'action e all'ad- 
dressing. Da notare anche due nodi abbastanza im- 
portanti: 

<wsu:Created>2004-09-01T23:17:42Z</wsu:Created> 
<wsu:Expires> 2004-09-0 1T23: 22 :42Z</wsu:Expires> 

che identificano il momento di creazione del mes- 
saggio stesso nonché la sua scadenza. 



IL MOSTRO IIUSTAIUT 
MESSENGER 

Ora che abbiamo visto com'è fatto un messaggio e 
come si crea, realizziamo un piccolo Instant Mes- 
senger. Quello che realizzeremo è sostanzialmente 
un piccolo software che consente lo scambio dei 
messaggi tra due client. L'esempio, sebbene sia ab- 
bastanza semplice nella sua logica, evidenzia due 
aspetti importanti di WSE: 

1. la comunicazione avviene punto - punto, quin- 
di senza la necessità di avere un server web che 
ospiti il Web Service; 

2. la comunicazione avviene sfruttando un proto- 
collo diverso dall'HTTE 

Torniamo al nostro progetto Windows Form creato 
precedentemente e, seguendo la stessa procedura 
applicata al progetto SoapMessage, aggiungiamo 
due riferimenti: Microsoft. Web.Service2 MI e System. 
Web.dll. L'utilizzo di System.Web .dli è indispensabi- 
le in quanto una delle classi che utilizzeremo (Soap- 
Receiver), implementa internamente l'interfaccia 
IHttpHandler contenuta appunto in System.Web.dll. 
Con la direttiva using, definiamo subito quali name- 
space utilizzare nella nostra applicazione: 

using Microsoft. Web. Services2; 

using Microsoft. Web. Services2.Addressing; 

using Microsoft. Web. Services2.Messaging; 

che, come abbiamo visto nell'esempio precedente, 



ci consentono di definire il messaggio e gli indirizzi 
a cui lo stesso deve essere inviato. Prepariamo quin- 
di un form che assomigli a quello di Fig. 1 e definia- 
mone il comportamento. Come prima cosa dobbia- 
mo costruire il messaggio SOAP da inviare. Lo fac- 
ciamo sull'evento click del pulsante Invia: 

private void btnInviaMessaggio_Click(object sender, 

System. EventArgs e) { 
SoapEnvelope messaggio = new SoapEnvelope(); 
messaggio. SetBodyObject(tbxMessaggioDalnviare.Text); 
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A differenza dell'esempio 
SoapMessage visto in pre- 
cedenza, questa volta la- 
sciamo che sia motore 
WSE a creare per noi il 
body del messaggio. Al 
metodo SetBodyObject del 
nostro envelope, passia- 
mo la textBox contenente 
il messaggio che abbiamo 
scritto. Il motore di seria- 
lizzazione si occuperà di 
creare gli opportuni nodi 
XML al fine di realizzare 
un XML valido. Preparato 
il messaggio, dobbiamo 

indirizzarlo a qualcuno. Di questo se ne occupa la 
sezione Addressing del Contex del nostro SoapEn- 
velope (nel nostro caso è messaggio). 
Definiamo quindi una Action: 

messaggio. Context. Addressing. Action = new 

Action("urn:IM"); 

successivamente, indichiamo gli indirizzi del mit- 
tente e del destinatario. Queste informazioni ver- 
ranno inserite neU'envelope e ci consentiranno di 
scambiare il messaggio SOAP che abbiamo prece- 
dentemente creato. 

messaggio. Context. Addressing. From = new From( 

new Uri(tbxInAscoltoSu.Text)); 
messaggio. Context. Addressing.To = new To(new Uri( 

tbxTo.Text)); 

Giunti a questo punto, si potrebbe pensare che le 
informazioni sull'addressing siano state già inserite 
nel messaggio. Basterà però salvare il messaggio co- 
me abbiamo fatto in precedenza (messaggio.Save 
(patii)) per rendersi conto che questo non è vero. 
Riprendiamo l'immagine di Fig. 2. Noi siamo anco- 
ra sotto il cilindro della Pipeline! Per far si che le 
informazioni aggiuntive che abbiamo preparato 
siano inserite nel messaggio stesso, dobbiamo o for- 
zare la Pipeline (come abbiamo fatto nel preceden- 
te messaggio), oppure inviare il messaggio stesso: 
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Fig. 3: Messaggio SOAP processato dalla Pipeline 




APPROFONDIMENTI 



Il download di WSE 2.0 
(ora giunto alla SPI) è 
disponibile qui: 

www.microsoft.com/ 
downloads/details.aspx? 
Familvld=FC5F06C5-821F- 
41 D3-A4FE-6C7B56423841 
&displavlanq=en 

Paolo Pialorsi, 
di DevLeap 

www.devleap.com 
ha messo on line 
quattro interessanti 
video (in inglese) su 
WSE 2. 1 contenuti sono 
raggiungibili qui: 
www.devleap.com/ 
SchedaArticolo.aspx? 
ldArticolo=10730 
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APPROFONDIMENTI 



Su Windows XP, se 

avete il firewall 

abilitato, non 

dimenticate di aprire le 

porte utilizzate per la 

comunicazione punto - 

punto. Nella SP2 di 

Windows XP invece, il 

firewall integrato vi 

chiederà cosa fare. 

Autorizzate il 

programma per fare i 

test. 



SoapSender sSender = new SoapSender(new 

Uri(tbxTo.Text)); 

sSender.Send(messaggio); 

Sarà il SoapSender a far passare il messaggio dalla 
Pipeline che "pluggherà" in esso tutte le informazio- 
ni extra tipiche di WSE. Se salviamo ora il messaggio, 
ci troveremo d'avanti qualcosa di molto simile alla 
Fig. 4 in cui è ben visibile il messaggio scritto, inseri- 
to in un nodo XML dal SetBodyObject. Completata la 
parte relativa all'invio del messaggio, realizziamo 
quella per la ricezione. Definiamo una classe Rice- 
vitore che avrà il compito di ricevere il messaggio e 
di mostrarlo nell'apposita area. Ricevitore è una clas- 
se che deriva dalla SoapReceiver, di cui fa l'override 
del metodo Receive. 

public class Ricevitore : SoapReceiver { 
public RichTextBox MessaggioRicevuto; 
public TextBox To; 

protected override void Receive(SoapEnvelope envelope) { 
MessaggioRicevuto.AppendText(envelope.GetBodyObject( 
typeof(String)).ToString()+"\r\n"); 
To.Text = envelope. Context.Addressing.From 

.Address.Value.AbsoluteUri; }} 

Receive prende come argomento un SoapEnvelope 
(nel caso specifico, quello che abbiamo inviato con 
sSender.SendO) . Dall' envelope ricevuto, estraiamo 
due informazioni: 

1. Il messaggio vero e proprio; quello che abbiamo 
scritto nella textbox tbxMessaggioDalnviare 

2. Il mittente del messaggio che diventerà desti- 
natario a cui inviare la risposta. 

Manca ancora qualcosa. Stiamo realizzando una co- 
municazione punto - punto ma. . . non abbiamo an- 
cora definito i due punti della comunicazione! De- 
mandiamo il compito all'evento click del bottone 
btnlnAscoltoSu che, tra le altre operazioni di relativa 
importanza, creerà un EndPoint: 

SoapReceivers.Add(new EndpointReference(new 

Uri(tbxInAscoltoSu.Text)), ricevitore); 

Che sarà in pratica, il "punto" della comunicazione 
punto - punto. Il metodo Add di SoapReceiver ha 
quattro overload. Noi utilizzeremo il quarto che si 
aspetta due parametri: 

1. Un EndPoint caratterizzato da un Uri. Nel nostro 
caso, F Uri è quello che abbiamo dichiarato nella 
textbox tbxInAscoltoSu. 

2. Il secondo parametro è un riferimento all'og- 
getto che si occuperà di ricevere il nostro mes- 
saggio. Nel nostro caso, passeremo una istanza 
della classe Ricevitore. 



Abbiamo praticamente detto al nostro programma 
che deve aspettarsi i dati all'indirizzo che abbiamo 
specificato nella tbxInAscoltoSu e che, chi riceverà i 
messaggi è la nostra classe ricevitore. 



moni CI RESTA 
CHE PARLARE 

Abbiamo il nostro sistema di Instant Messaging per- 
sonale, ora non ci resta che provarlo! Avviamo due 
volte il programma e predisponiamolo alla comuni- 
cazione. Nella prima finestra, dichiariamo un indi- 
rizzo, completo di porta, rispetto al quale ci mettere- 
mo in ascolto. Ad esempio soap.tcp:lllocalhost:9000l 
IMe clicchiamo sul pulsante In Ascolto. Nella secon- 
da finestra, definiamo una porta diversa, ad esem- 
pio soap.tcp:// localhost:9001/IM e, anche qui, clic- 
chiamo sul relativo pulsante. Torniamo nella prima 
finestra, inseriamo l'indirizzo di destinazione nella 
casella To (in questo caso sarà quello in cui abbiamo 
messo in ascolto la seconda finestra), scriviamo 
qualcosa nell'apposita area e premiamo Invia. Il no- 
stro messaggio sarà inviato all'indirizzo del destina- 
tario e, oltre ad apparire nell'area dedicata ai mes- 
saggi, verrà compilato automaticamente anche il 
campo To. Se il test va a buon fine, possiamo utiliz- 
zare il nostro Messenger su due PC diversi. La proce- 
dura è identica tranne che per due fattori: l'indirizzo 
di ascolto (localhost) deve essere sostituito con l'IP 
pubblico del PC su cui è in esecuzione il program- 
ma. Per recuperarlo, avviamo la shell (start/esegui 
Icmd) e digitiamo il comando ipconfig. Se inoltre ab- 
biamo un firewall attivo (Windows XP lo ha), dob- 
biamo aprire la porta scelta per la ricezione dei mes- 
saggi (nel caso dell'esempio è la porta 9000). 



CONCLUSIONI 

In questo articolo abbiamo visto alcune delle carat- 
teristiche generali di Web Service Enhancements 
2.0. L'esempio dellìnstant Messenger ha lo scopo di 
mostrare solo una piccola parte delle potenzialità di 
questa architettura nonché una delle differenze 
sostanziali rispetto ai tradizionali servizi Web: l'as- 
senza del server Web. L'utilizzo di WSE in ambienti 
professionali può portare enormi vantaggi sia in ter- 
mini economici (tempo risparmiato nella scrittura 
del codice, server in meno da gestire e configurare 
ecc.), sia in termini di funzionalità e di sicurezza. Un 
personale consiglio è quello di approfondire l'argo- 
mento, sia per coglierne già da oggi i vantaggi, sia 
per essere pronti in futuro (nemmeno troppo lonta- 
no) ad Indigo. Nel prossimo numero amplieremo 
nostro Instant Messenger implementando anche 
l'invio di file in allegato. Buon lavoro. 

Michele Locuratolo 
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Miglioriamo le nostre applicazioni con il VB Power Pack 

VB Power Pack 

VB.NET permette la realizzazione di applicazioni molto interessanti, 
ma per un'interfaccia grafica "avanzata" bisogna ricorrere a dei 
componenti esterni: proviamo sette nuovi controlli gratuiti 




U CD LI WEB 

FileSystemMonitor.zip 
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VB POWER 
PACK È GRATIS? 

Si, VB Power Pack è 

completamente 

gratuito, sia per 

l'utilizzo personale, sia 

per lo sviluppo di 

applicazioni 

commerciali. 




t Nozioni base di VB.NET 



Windows 
NT/2000/XP/2003, 
Visual Studio .NET 2003 



|||3 g|| g=lj 



La ricchezza della libreria .NET e la completez- 
za del linguaggio permettono finalmente di 
realizzare qualsiasi tipo di applicazione, an- 
che quelle più sofisticate, dotate di funzionalità mol- 
to difficili da realizzare in Visual Basic 6, come ad 
esempio la gestione del multi-threading. La parte 
forse più debole, però, rimane quella dell'interfaccia 
utente. La Microsoft e altri produttori ci hanno abi- 
tuato ad interfacce sofisticate, con TaskPane collas- 
sabili, finestre di notifica (Toast) alla MSN Messen- 
ger, sfondi colorati, barre e bottoni grafici, etc. . . 
.NET non dispone di questo genere di controlli, ma 
ha tutte le potenzialità per realizzarli. Il Visual Basic 
Power Pack è un insieme di controlli grafici scritti in 
VB.NET, che possono però essere utilizzati in qual- 
siasi linguaggio .NET. In questo articolo vedremo co- 
me utilizzarli per migliorare l'interfaccia utente della 
nostra applicazione. 



FileSystemMonitor 

Scopo dell'applicazione che verrà realizzata è quello 
di permettere di controllare file e cartelle, anche più 
di una contemporaneamente, e di notificare l'uten- 
te quando si verifica un cambiamento. Per funzio- 
nare sfrutta la classe FileSystemWatcher di .NET, che 
funziona solo su sistemi operativi della famiglia 
Windows NT, quindi: NT4, 2000, XP e 2003. L'inter- 



Tempo di realizzazione 



/J FileSystemMonitor 
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faccia utente dell'applicazione è mostrata in Fig. 1. 
Come si vede in figura, è in corso il monitoraggio del 
file "prova.txt" e della cartella "C:\Downloads". Si è 
scelto di utilizzare un'interfaccia di tipo "tabbed", 
come fanno il Visual Studio.NET, browser come Fi- 
reFox o Maxthon, e programmi come UltraEdit, 
ecc.. Questo approccio è più user friendly dei nor- 
mali approcci SDÌ e MDI, supportati nativamente 
dal framework. Per implementare questo tipo di in- 
terfaccia si è scelto un TabControl impostato in mo- 
dalità Fiat. 



INTRODUZIONE 
Al CONTROLLI 
DEL POWER PACK 

Il Power Pack comprende i seguenti controlli: 

BlendPanel - permette di inserire sfondi sfuma- 
ti sulle nostre form. 

UtilityToolbar - è una toolbar molto simile a 
quella di Internet Explorer. 
ImageButton - è un pulsante che permette di 
mostrare immagini su sfondo trasparente. 
NotiflcationWindow - è la finestrella di notifica 
(alla MSN Messenger). 

TaskPane - è molto simile alla barra "collassabi- 
le" presente ne\Y Esplora Risorse di Windows XP 
FolderViewer - è un TreeView che mostra le 



Fig. 1: Interfaccia utente dell'applicazione 
FileSystemMonitor 
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Fig. 2: Selezione dei componenti del Power Pack 
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Directory dell'hard disk. 
• FileViewer - è una ListView ottimizzata per 
mostrare file. 

Il Power Pack è liberamente scaricabile e ridistribui- 
bile (sia la dll, sia i sorgenti) con una licenza di tipo 
Shared Source. Per semplificare l'utilizzo dei control- 
li, conviene aggiungerli alla Toolbox del Visual Stu- 
dio, premendo il tasto destro sulla Toolbox stessa e 
selezionando Aggiungi/Rimuovi (Add Remove 
Items. . .). Si possono vedere i vari componenti da ag- 
giungere in Fig. 2: tutti i componenti appartengono 
al namespace VbPowerPack. 
A questo punto, i controlli possono essere trascinati 
sulle nostre form e utilizzati come se fossero compo- 
nenti di sistema. Per comodità io li ho inseriti in una 
sezione apposta della Toolbox (Fig. 3). 



LA FORM PRINCIPALE 

Di seguito trovate un elenco degli elementi che an- 
dranno a comporre la form. 



• Un controllo MainMenu di .NET (MaìnMenul) 

• Un controllo UtilityToolbar del VB PowerPack 
(UtTMain), con Appearance=Flat e Dock-Top 

• Un controllo TabControl di .NET (TabCMain), 
con Anchor su tutti e quattro i lati, e grande come 
tutta la Form esclusi la Toolbar e la StatusBar 

• Un controllo StatusBar di .NET (StatusBarl), 
con Dock=Bottom 

• Un controllo NotificationWindow del VB Power- 
Pack (NotificationWindowl), con ShowStyle= Fa- 
de, CloseButton-True, e con i colori di sfondo che 
più ci piacciono 

• Un controllo ContextMenu di .NET (ContextMe- 
nul) 

• Un controllo Notifylcon di .NET (Notifylconl), 
con ContextMenu=ContextMenul, l'icona Nor- 
mal.ICO e Visible=False 

Selezionando la UtilityToolbar nel pannello delle 
proprietà, e premendo tasto in corrispondenza di 
Buttons è possibile configurare i bottoni presenti 
nella Toolbar, come in Fig. 4. La Toolbar del VB Po- 
wer Pack è ottimizzata per contenere quei particola- 
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Fig. 4: Configurazione Toolbar 



ri bottoni. Può essere estesa anche con altri pulsan- 
ti, ma purtroppo non possono avere icone, in quan- 
to il controllo non lo permette. A questo punto, asso- 
ciamo al tasto Search della Toolbar e al menu File- 
>New, l'handler degli eventi che ci permetterà di ag- 
giungere i file da monitorare. Tralasciando per ora la 
selezione del file o della cartella, occupiamoci di 
creare la parte grafica che mostrerà il log delle modi- 
fiche e che preparerà il FileSystemWatcher: 

Dim frmCh As New FormChoose, wPath As String, 

wFilter As String, tp As TabPage 

If frmCh.ShowDialogQ = DialogResult.OK Then 

wPath = frmCh.Path 

wFilter = frmCh.Filter 

If frmCh.IsFile Then 

tp = New TabPage(wPath) 

Else 

tp = New TabPage(wFìlter) 

End If 

tp.Dock = DockStyle.Fill 

Dim t As New TextBox 

t.ScrollBars = ScrollBars.Both 
t.WordWrap = False 
t.Multiline = True 
t.ReadOnly = True 

t.Dock = DockStyle.Fill 

tp. Controls. Add(t) 

Me. TabCMain. TabPages.Add(tp) 

Dim watcher As FileSystemWatcher = New 

FileSystemWatcher 
watcher.Path = wPath 
watcher.Filter = wFilter 

watcher. NotifyFilter = CType(frmCh.NotifyFilt, NotifyFilters) 
watcher.EnableRaisingEvents = True 
AddHandler watcher.Changed, New FileSystemEventHandler 

(AddressOf Me.OnDiskChanged) 

Dim fw As FileWatcher 
fw. Watcher = watcher 
fw. TabPage = x 

Watchers.Add(fw) 

End If 

Me.StatusBarl.Text = "Currently monitoring " + 

Watchers.Count.ToStrìng + " file(s)/dir(s)..." 

In cui Watchers è una ArrayList che ci permetterà di 
recuperare a runtime le informazioni che ci servono. 
Watchers contiene la seguente struttura: 

Private Structure FileWatcher 
Public Watcher As FileSystemWatcher 
Public TabPage As TabPage 
End Structure 

Per intercettare gli eventi generati dal FileSystem- 
Watcher dobbiamo preparare il suo event handler. 
Gli eventi generati dal FileSystemWatcher vengono 
generati in un altro thread e quindi, per poter inte- 
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Fig. 3: Toolbar del Visual 
Studio modificata 



VB POWER 
PACK È uni 
PRODOTTO 
SUPPORTATO? 

No, VB Power Pack è un 
prodotto rilasciato con 
licenza Shared Source, 
di cui sono disponibili i 
sorgenti, e che NON è 
ufficialmente 
supportato da 
Microsoft. Però sul 
Workspace GotDotNet 
che lo ospita potete 
trovare tutte le risorse 
e gli aiuti necessari. 



http://www.ioprogrammo.it 



Novembre 2004/ 83 ► 



SISTEMA T ■ Migliorare le interfacce in VB.NET 




jMO ]<-,&* 



Fig. 5: Icona del 
programma nella 
Notification Area 



VB POWER 

PACK GIRA 

ANCHE CON C#? 

Naturalmente sì. 

I controlli contenuti 

nel VB Power Pack 

possono essere 

utilizzati in C# e in 

tutti gli altri linguaggi 

.NET che supportano le 

Windows Forms. 



ragire con l'interfaccia utente, dobbiamo utilizzare 
l'istruzione Invoke sulla nostra forni, altrimenti si 
potrebbero avere problemi molto seri, fino al blocco 
dell'applicazione. Nel nostro caso, il controllo Noti- 
ficationWindow non funziona se richiamato da un 
altro thread, e rimane dello "sporco" sullo schermo. 
Dobbiamo quindi, prima di tutto, preparare un dele- 
gate che ci permetterà di trasferire il controllo al 
thread della form principale: 

Private Delegate Sub MarshalFSWEventToUIThread( 

ByVal source As Object, ByVal e As 
FileSystemEventArgs) 

Il delegate ha la stessa firma dell'evento generato dal 
FileSystemWatcher, cosa che ci permetterà di passa- 
re gli stessi parametri al thread che gestisce l'inter- 
faccia utente. Possiamo quindi preparare i due event 
handler: uno che verrà eseguito nel thread seconda- 
rio del FileSystemWatcher, e uno a cui verrà trasferi- 
to il controllo sul thread principale. 

Private Sub OnDiskChanged(ByVal source As Object, 

ByVal e As FileSystemEventArgs) 
Dim args() As Object = {source, e} 
Me.Invoke(l\lew MarshalFSWEventToUIThread( 

AddressOf OnDiskChanged_UI), args) 

End Sub 

Private Sub OnDiskChanged_UI(ByVal source As 

Object, ByVal e As FileSystemEventArgs) 
For Each watch As FileWatcher In Watchers 
If watch. Watcher Is CType(source, FileSystemWatcher) Then 
NWLastMessage = DateTime.Now.ToShortTimeString + 
" " + Path.GetFileName(e.FullPath) + " " + 
e.ChangeType.ToString 
CType(watch.TabPage.Controls(0), TextBox).Text + = 

NWLastMessage + vbCrLf 
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Fig. 6: Form per selezionare file o cartelle 



If Me.ShowToast Then 

If NWForm Is Nothing OrElse NWForm.Visible = False Then 

NWForm = Me.NotificationWindowl.Notify(NWLastMessage) 

End If 

End If 

If Me.Notifylconl.Visible = True Then 

Me.Notifylconl.Icon = New Icon(Me.GetType, 

"Changed.ICO") 

End If 

Exit For 

End If 

Next 

End Sub 

Nell'event handler che si occupa di gestire l'interfac- 
cia utente, viene ricavato quale Watcher della colle- 
zione ha generato l'evento, viene impostato l'ultimo 
messaggio (nel caso lo si voglia rivedere), viene scrit- 
to il messaggio nel TextBox e, se si vogliono visualiz- 
zare i messaggi nella NotificationWindow, viene mo- 
strato il Toast. Si noti che messaggio viene mostra- 
to solo se la finestra di un messaggio precedente è 
già sparita, altrimenti si correrebbe il rischio di riem- 
pire lo schermo di finestrelle (mi è capitato durante 
lo sviluppo. . .). Inoltre, se la Notifylcon è visibile, vie- 
ne cambiata con un'altra icona, per segnalare all'u- 
tente la modifica. 



MINIMIZZAZIONE 
NELLA NOTIFICATION 
AREA 

Il programma consente anche di essere minimizza- 
to nella Notification Area (vicino all'orologio, come 
in Fig. 5). Per fare questo si usa il seguente codice: 

Private Sub FormMain_LocationChanged(ByVal sender 

As Object, ByVal e As System. EventArgs) Handles 

MyBase.LocationChanged 

If Me.WindowState = FormWindowState.Minimized And 

Me.MinimizelnNotifyArea Then 

Me.ShowInTaskbar = False 

Me.Notifylconl.Visible = True 

End If 

End Sub 

Private Sub Notifylcon l_DoubleClick(ByVal sender As 

Object, ByVal e As System. EventArgs) Handles 
Notifylcon 1. DoubleClick, MenuItemShow. Click 
Me.ShowInTaskbar = True 
Me.WindowState = FormWindowState.Normal 
Me.Notifylconl.Visible = False 
Me.Notifylconl.Icon = New Icon(Me.GetType, 

"Normal.ICO") 

End Sub 

Come si vede, si intercetta l'evento LocationChan- 
ged della form e si verifica se la form è stata mini- 



». 84 /Novembre 2004 



http://www.ioprogrammo.it 



Migliorare le interfacce in VB.NET ■ T SISTEMA 



mizzata. A quel punto, se l'utente preferisce la mini- 
mizzazione nella Notification Area, si toglie la form 
dalla TaskBar e si visualizza l'iconcina. In caso di 
doppio click sull'iconcina, o in caso di click sul 
menu contestuale associato all'iconcina alla voce 
Show, si provvede a ripristinare la form, e a ripristi- 
nare l'icona (che potrebbe essere stata cambiata per 
segnalare all'utente l'arrivo di uno o più eventi). 



SELEZIONE DI FILE 
E CARTELLE 

La selezione viene effettuata tramite una form cu- 
stom, che ci permette di selezionare il file o la cartel- 
la da monitorare. In caso di cartella, si può imposta- 
re un filtro sui file da cercare, ed è possibile selezio- 
nare gli eventi da controllare (Fig. 6). Per ottenere 
questa form sono stati usati il controllo TaskPane, 
dove nei singoli Pane sono stati inseriti un controllo 
BlendPanel per dare lo sfondo e i controlli standard 
.NET richiesti (TextBox, e CheckBox), mentre per car- 
telle e file si sono utilizzati FolderViewer e il FileVie- 
wer del VB Power Pack. La TaskPane è completa- 
mente customizzabile, si possono scegliere i colori 
dello sfondo, del testo e si possono impostare le sfu- 
mature per le caselle dei titoli che servono anche a 
far "collassare" i vari Pane. 

All'interno del singolo Pane può essere messo qual- 
siasi tipo di controllo. La parte più interessante della 
form è quella che riguarda la sincronizzazione tra i 
due Viewer: 

Private Sub FolderViewerl_NodeClicked(ByVal sender 

As System. Object, ByVal e As 
VbPowerPack.Folder ViewerEventArgs) 
Handles FolderViewerl.NodeClicked 
Try 

Me.FileViewerl.Path = Me.FolderViewerl.CurrentFolder 
Catch ex As Exception 
Me.FileViewerl.Path = "My Computer" 
End Try 

File = "" 

End Sub 

Private Sub FileViewerl_ItemDoubleClicked(ByVal sender 
As Object, ByVal fvea As VbPowerPack. FileViewer 
EventArgs) Handles FileViewerl.ItemDoubleClicked 
If fvea.Item.IsFolder Then 
Me.FolderViewerl.CurrentFolder = fvea.Item.FullPath 

Else 

DialogResult = DialogResult.OK 

End If 

End Sub 

Se viene selezionato un nodo nel FolderViewer, vie- 
ne settato il Path nel FileViewer. In questo caso ci può 
essere un problema in caso della cartella My Com- 
puter, che va settata esplicitamente in caso di ecce- 



zione. Se viene selezionato un elemento del FileVie- 
wer, viene controllato se è un file o una cartella. Nel 
primo caso si esce, nel secondo si imposta il Full- 
Path del FolderViewer alla cartella selezionata. 
Per il resto, la form contiene solo la definizione delle 
proprietà che verranno lette dalla routine che crea 
un nuovo FileSystemWatcher. L'unica altra parte di 
rilievo è la gestione dei Flag per decidere gli eventi 
del FileSystem da monitorare. Per questo viene defi- 
nita una proprietà che mappa il valore dei vari 
CheckBox (se ne mostrano solo alcuni): 



Public ReadOnly Property NotifyFilt() As Integer 


Get 


Dim vai As Integer 


= 


If Me.chkAttributes.Checked Then vai + = 

NotifyFilters.Attribut.es 


If Me.chkCreatTime 


Checked Then vai + = 

NotifyFilters.CreationTime 


Return vai 


End Get 


End Property 



FUNZIONALITÀ 
ACCESSORIE 

Per rimuovere un file o una cartella dal monitorag- 
gio, si utilizza il seguente codice, associato alla voce 
di menu e al pulsante Delete della Toolbar. 

Private Sub UtTMain_DeletePressed(ByVal sender As 
System. Object, ByVal e As System. EventArgs) Handles 
UtTMain.DeletePressed, MenuItemRemove. Click 
If Me.TabCMain.Selectedlndex > -1 Then 
RemoveHandler CType(Me.Watchers( 

Me.TabCMain.Selectedlndex), FileWatcher) 
.Watcher.Changed, AddressOf Me.OnDiskChanged 
Me.watchers.RemoveAt(Me.TabCMain.Selectedlndex) 
Me.TabCMain.TabPages.RemoveAt(Me.TabCMain.Selectedlndex) 
Me.StatusBarl.Text = "Currently monitoring " + 

Watchers.Count.ToString + " file(s)/dir(s)..." 

End If 

End Sub 

Praticamente si controlla se c'è una Tab Page selezio- 
nata e si rimuove il corrispondente elemento 
dell'ArrayList, ricordandosi di deregistrare l'evento 
dal FileSystemWatcher. Per muoversi avanti e indie- 
tro si incrementa e decrementa l'indice della pagina 
attiva del TabCMain, mentre per ripulire il TextBox, 
si usa seguente codice: 

CType(Me.TabCMain.TabPages(Me.TabCMain.SelectedIndex) 
.Controls(O), TextBox). Text = "" 

I tooltip dei bottoni della Toolbar non sono adatti 
alla nostra applicazione, e quindi all'atto del Form_ 





APPROFONDIMENTI 



MULTITHREADING 
E WINDOWS 
FORMS 

Per un approfondimento 
sul problema del 
multithreading e l'uso 
delle Windows Forms si 
può guardare il 
seguente articolo di 
Corrado Cavalli (richiede 
registrazione al sito): 

www.uqidotnet.org/articles/ 
articles read.aspx?ID=19 



[J 



m 



|~~l Show Notification Window (Toast) 
I I Always start minimized 
Minirnize in NotifyÀrea 



Ok 



Fig. 7: Form per 
modificare le opzioni 




SUL WEB 



Il sito ufficiale del VB 
Power Pack è 

www.qotdotnet.com/ 
Workspaces/Workspace. 
aspx?id=167542e0-e435- 
4585-ae4f-c111fe60ed58 
da cui si possono 
scaricare i sorgenti, gli 
installer sia per Visual 
Studio .NET 2003, sia 
per la 2002. C'è anche 
una message board e 
un sistema per il 
reporting dei problemi. 
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Load li cambiamo, utilizzando la seguente istruzio- 
ne (ne viene mostrato solo uno): 

Me.SearchUtilityButtonl.ToolTipText = "New" 

Le informazioni di configurazione vengono lette nel 
Form_Load, e se è richiesta la partenza minimizzata, 
viene attivata: 




CONTROLLI UTILIZZATI NEL PROGETTO 

Nel progetto si sono utilizzati tutti i controlli presenti nel VB PowerPack. 
Nella FormMaìn ci sono la NotificationWindow e ì'UtilityToolbar, nella 
FormAbout ci sono il BlendPanel e V ImageButton, mentre nella 
FormChoose ci sono la TaskPane (che contiene due BlendPanel), il 
FolderViewer e il FileViewer. 



xmlElm.SetAttribute("value", Me.StartMinimized.ToString) 
xmlDom.Save(Application.ExecutablePath + ".config") 

Un effetto interessante può essere ottenuto nella 
form di About del programma, utilizzando il 
BlendPanel, una PictureBox standard .NET e un 
controllo ImageButton, come mostrato in Fig. 8. 
L'unica accortezza è che sembra che la proprietà 
DialogResult dell' ImageButton non funziona, 
quindi ho intercettato l'evento Click e l'ho impo- 
stata a mano. È stata implementata anche la pos- 
sibilità di rivedere (quando il programma è mini- 
mizzato nella Notification Area) l'ultimo messag- 
gio registrato, per non dover per forza aprire l'in- 
terfaccia utente. Si noti che il messaggio mostrato 
è l'ultimo arrivato al programma, non l'ultimo 
mostrato (potrebbero essere diversi se arrivano 
tanti messaggi contemporaneamente) . 
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Fig. 9: NotificationWin- 
dows in basso a destra 
dello schermo 



Me.ShowToast = Boolean.Parse(Configuration. 
ConfigurationSettings.AppSettings("ShowToast").ToString()) 
Me.StartMinimized = Boolean.Parse(Configuration. 
ConfigurationSettings.AppSettings("StartMinimized") 

.ToStringO) 

Me.MinimizelnNotifyArea = Boolean.Parse(Configuration. 

Configli rationSettings.AppSettings("MinimizeInNotifyAr 

ea").ToString()) 
If Me.StartMinimized Then 

Me.WindowState = FormWindowState.Minimized 
End If 

Per modificare le preference si utilizza una form 
apposta (Fig. 7). 



+) About, 



M 




FileSystemMonitor v.1 .0.100.0 

Writien djj: Barbilor 
Crediti to: VB Power Pack Team 



Fig. 8: Form di About 

Per salvarle si deve operare direttamente sul file 
XML contenente la configurazione (viene mostra- 
ta la modifica di un solo campo): 

Dim xmlDom As New Xml.XmlDocument 
Dim xmlElm As Xml.XmlElement 
xmlDom.Load(Application.ExecutablePath + ".config") 
xmlElm = CType(xmlDom.SelectSingleNode( 

7/add[<akey='StartMinimized']"), 
Xml.XmlElement) 



PROBLEMI 
RISCONTRATI 

Il VB Power Pack è un progetto giovane, che non è 
esente da qualche piccolo problema. Tra i più fasti- 
diosi si registra nella gestione della NotificationWin- 
dow, che appare (sul mio sistema) in basso a sinistra 
invece che in basso a destra come Messenger. Inol- 
tre, se si seleziona la modalità Slide, la finestrella vie- 
ne srotolata nella direzione sbagliata (secondo me, 
ma la spiegazione presente sul sito ufficiale recita 
che è cosi "by design"...). Questi problemi possono 
essere sistemati intervenendo sui sorgenti. Anche se, 
pensandoci bene, è più che altro una questione di 
gusti! Ci sono altri piccoli problemi come il Dialog- 
Result AeWImageButton che non funziona a dovere, 
o il Path del FileViewer che non accetta la selezione 
di "My Computer" fatta dal FolderViewer, ma sono 
problemi semplicissimi da risolvere. La disponibilità 
sul Workspace GotDotNet dei sorgenti ci è poi d'aiu- 
to nel caso volessimo customizzare i controlli a no- 
stro piacere. 



CONCLUSIONI 

Abbiamo visto come realizzare un'applicazione 
molto semplice, ma dotata di tutte le feature 
delle applicazioni più moderne (minimizzazione 
nella Notification Area, finestrella toast per la 
notifica dei messaggi, TaskPane alla Windows XP, 
dialog di selezione dei file customizzata, etc...). 
Nel prossimo numero estenderemo l'applicazio- 
ne introducendo l'uso di alcuni Application 
Block disponibili gratuitamente sul sito MSDN, 
che ci permetteranno di aggiungere altre feature 
interessanti alla nostra applicazione. 

Lorenzo Barbieri 
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Un'introduzione al nuovo IDE open-source 

Sviluppare in Java 
con Eclipse 3 

Continuiamo la nostra esplorazione del mondo di Eclipse 

con la gestione degli eventi nel Visual Editor e un'introduzione 

al framework grafico SWT, ideale per prestazioni e flessibilità 



parte seconda 
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Eclipse 3.0 e JDK 
1.4.2 su qualunque 
sistema operativo 
supportato (Linux, 
HP-UX, AIX, Solaris, 
Windows, MacOS) 






Tempo di realizzazione 



Visto l'enorme successo del progetto open- 
source Eclipse presso la comunità Java e ol- 
tre, abbiamo iniziato nel numero scorso una 
mini-serie di presentazione di Eclipse 3.0, l'ultima 
versione del popolare tool di sviluppo rilasciata a 
luglio di quest'anno. Volendo dare una panoramica 
delle capacità dell'ambiente di sviluppo in relazione 
ad altri prodotti similari, abbiamo anche introdotto 
ai lettori il sottoprogetto VEP (Visual Editor Project) , 
un plug-in aggiuntivo che dà la possibilità di creare 
interfacce grafiche in maniera visuale e semplice. 
Siamo partiti dalla creazione di una applicazione 
calcolatrice, la cui interfaccia è stata appunto dise- 
gnata con VE ed è rappresentata nella Fig. 1. 
Abbiamo visto come sia possibile gestire layout 
GridBagLayout di Swing per collocare sulla finestra i 
vari componenti e dare loro una posizione e dimen- 
sione. Oggi partiamo invece dalla gestione degli 
eventi. 
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Fig. 1: L'interfaccia grafica della semplice calcolatri- 
ce Java d'esempio 



CREARE E GESTIRE 
GLI EVENTI COnl VE 

Grazie al plug-in VE possiamo aggiungere facilmen- 
te degli ascoltatori ai vari elementi che un form con- 
tiene. Cliccando con il tasto destro su un compo- 
nente, si aprirà il menu contestuale, nel quale tro- 



viamo la voce Events (vedi Fig. 2). Da lì è possibile 
aprire la finestra di dialogo Add Events (vedi Fig. 3), 
nella quale si può scegliere tra tutte le tipologie di 
ascoltatore che il componente selezionato supporta, 
oppure utilizzare le scorciatoie per creare diretta- 
mente un ascoltatore per gli eventi più comuni del 
tal componente. 



Undo Ctrl+Z 

Redo Cttl+Y 



Open 

Op" ; -n l'ypaHierarorr;,' 



Renarne Field 
X Delete 



set Text 
C^tumize Layout., 



©* actionPerfotmed 

@* enabled 

P model 
text 



Fig. 2: Il menu per l'aggiunta di gestori d'evento ai 
componenti di una finestra 

Il codice di evento che viene generato prevede la 
creazione di una classe anonima passata come para- 
metro del metodo di registrazione dell'evento, come 
nell'esempio che segue: 
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Fig. 3: La finestra con tutti i gestori d'evento disponi- 
bili per un componente 
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button.addActionListener(new java.awt.event. 

ActionListener() { 
public void actionPerformed( 

java.awt.event.ActionEvent e) { 

// TODO Auto-generated Event stub actionPerformed() 

_J 

}); 

Non è quindi possibile, utilizzando l'aiuto fornito 
dal VE, creare una sola classe registrata come ascol- 
tatrice per più di un componente. I pulsanti Swing, 
però hanno anche una proprietà azione con cui si 
può specificare una classe da usare per gestire l'e- 
vento actionPerformed. Tale classe deve essere una 
derivata di javax.swingAbstractActìon e potrà essere 
associata alla proprietà Action dei vari componenti 
di una finestra tramite la view "Properties". Nella no- 
stra calcolatrice abbiamo così usato una sola classe 
(CalcBtnAction) per gestire il click di tutti i pulsanti 
presenti: ognuno contribuirà una cifra o una opera- 
zione a seconda del testo che visualizza. 
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Fig. 4: Il menu di selezione per la visualizzazione degli 
eventi della Java Beans view 

Nel momento in cui abbiamo degli eventi gestiti nel 
nostro codice, la view "Java Beans" diviene un pre- 
zioso strumento di consultazione: essa, come abbia- 
mo visto nel numero scorso, offre una visualizzazio- 
ne della struttura dei componenti presenti in una 
classe visuale, ordinati gerarchicamente e seleziona- 
bili in modo da passare direttamente al codice nel- 
l'editor o all'elemento visuale nel designer grafico. 
Oggi, invece, scopriamo che, tramite un menu a 
comparsa (quello della Fig. 4), possiamo anche ve- 
dere in quella struttura tutti gli eventi che sono stati 
associati ai vari controlli ed eventualmente elimina- 
re quelli che non servono più. Il menu offre tre 
opzioni: la prima [No Events) fa sì che non vengano 
mostrati gli eventi nella view, mentre Show Events 
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mostra quali eventi sono gestiti per quali compo- 
nenti (come in Fig. 5). La terza opzione {Expert 
Events) offre anche il dettaglio sul modo in cui 
gestore è costruito (implementazione anonima di 
una interfaccia o estensione anonima di una classe), 
così che sapete esattamente che tipologie di gestori 
sono in esecuzione nella vostra applicazione (Fig. 6). 
Notate che, tramite la finestra di aggiunta degli 
eventi, (quella di figura wineventi) possiamo utiliz- 
zare una stessa classe anonima per gestire eventual- 
mente più eventi se essa lo consente: sostanzial- 
mente se un componente ha già una classe di ascol- 
to la cui interfaccia offre altri metodi di gestione 
eventi, allora la dialog box di aggiunta eventi darà la 
possibilità di riutilizzare quell'ascoltatore esistente 
abilitando il radio button relativo. 
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Fig. 5: la Java Beans view mostra gli eventi dei vari 
elementi 



Fig. 6: La modalità avanzata di visualizzazione eventi 
della Java Beans view 



LO STANDARD 
WIDGET TOOLKIT 

Iniziamo adesso a parlare della nostra seconda ap- 
plicazione di esempio, quella con cui andremo a ge- 
nerare un file PDF tramite una interessante libreria 
di oggetti lava completamente gratuita e open-sour- 
ce. Ma, prima di parlare di PDF, vorrei introdurre 
una nuova tecnologia di sviluppo di interfacce a fi- 
nestre che si è affacciata al mondo con l'uscita di 
Eclipse. Si tratta di SWT (lo Standard Widget Toolkit), 
una libreria grafica al pa- 
ri di AWT e Swing, nata in 
casa IBM e adesso parte 
integrante del progetto 
Eclipse, rispetto al quale 
comunque si propone 
come API indipendente. 
L'esigenza che ha portato 
a SWT è quella di unire 
alla portabilità del codice 
sviluppato anche una 
buona performance nel- 
l'esecuzione delle appli- 
cazioni. La prima tecno- 
logia visuale di Java fu 
l'AWT [Abstract Window 
Toolkit). Esso è molto ef- 





LO STANDARD WIDGET 
TOOLKIT 

SWT è stato sviluppato da IBM come base di 
appoggio per il progetto Eclipse con l'obiettivo 
di supplire alle carenze dei due sistemi grafici 
Java in esistenza (AWT e Swing). Per una guida 
all'architettura interna di questa nuova API 
potete fare riferimento a due interessanti 
articoli sul sito di Eclipse che presentano le 
caratteristiche di questo nuovo framework per 
creare applicazioni a finestre in Java: 
www.eclipse.orq/articles/Article-SWT-Desiqn-1/ 
SWT-Design-1.html 

www.eclipse.org/articles/swt-desiqn-2/ 
swt-desiqn-2.html 
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F/g. 7: La finestra di impostazione delle librerie di 
sviluppo 




SWT LAYOUTS 

I layout in SWT come in 

Swing determinano la 

posizione e la 

dimensione degli 

elementi all'interno di 

un contenitore. 

Un'ottima introduzione 

ai vari layout 

disponibili in SWT 

(sensibilmente diversi 

da quelli che si trovano 

in Swing) la trovate sul 

sito di Eclipse 

all'indirizzo 

www.eclipse.orq/articles/ 

Understanding%20Layouts/ 

Understandinq%20Lavouts, 

htm 



Sciente in quanto è basato sull'esecuzione di codice 
nativo, ma ha sacrificato alla portabilità il range di 
componenti offerti: affinché ogni controllo grafico 
potesse essere creato nativamente sul sistema ope- 
rativo di esecuzione dell'applicazione, l'offerta 
disponibile è limitata ai soli controlli disponibili su 
tutti gli ambienti di destinazione di Java. AWT quin- 
di risulta molto povero di scelta e poco flessibile. 
Swing invece, che arriva in forma finale con Java 1.2, 
rappresenta un cambio di politica radicale: non si 
usano più chiamate al sistema operativo sottostante 
per creare i controlli e gli 
elementi grafici delle fine- 
stre, tutto viene fatto al 
100% in Java. Questa alter- 
nativa risulta quindi sicu- 
ramente portabile e ricca 
di controlli e gadget di 
ogni genere, perché ades- 
so non ci si deve più sof- 
fermare a valutare quali 
sistemi supportino quali 
elementi. Lo svantaggio di 
Swing però risiede nelle 
scarse performance. Ren- 
dere tutto in Java costa 
molto in termini di risorse 
e tempo e, nonostante i 
grandi miglioramenti fatti con le varie implementa- 
zioni dell'API, la sua performance, pur accettabile, 
non è equiparabile a tecnologie parallele. Entra così 
in scena SWT: l'idea è questa volta di creare una li- 
breria Java comune alle varie piattaforme, la quale a 
sua volta si appoggia su una libreria interna di chia- 
mate native. L'implementazione di questa libreria 
nativa varia a seconda del sistema operativo facendo 
uso di oggetti specifici che inoltrano chiamate via 
JNI a librerie dinamiche del sistema operativo (.dll, 
.so, etc.) sviluppate in C appositamente per ogni 
piattaforma supportata. A differenza di AWT, però, 
questo approccio non si limita ad uno scarno set 
comune di componenti: dove i sistemi operativi non 
offrono supporto, la libreria nativa deve supplire con 
implementazioni 100% Java. In questo modo si 
ottengono applicazioni efficienti, portabili e flessibi- 
li e la stratificazione a tre livelli consente comunque 
di offrire ai programmatori un API universale. 
Eclipse ovviamente è la prima applicazione Java ad 
essere scritta con questa tecnologia. 



MANO AL CODICE! 

Scriviamo adesso anche noi la nostra applicazione 
SWT, cominciando col creare un nuovo progetto 
Java: io l'ho chiamato "PdfGeneratorWithEclipse", 
ma qualunque nome di vostra scelta andrà bene. Se- 
lezioniamo poi le proprietà del progetto per aggiun- 




Fig. 8: Selezioniamo la libreria SWT per il nostro 
nuovo progetto 

gere le librerie necessarie allo sviluppo con SWT: 
right-click sul progetto nella vista "Package Explorer" 
o "Navigator", menu Propertìes, item Java Build 
Path, pagina Libraries, come in Fig. 7. Da lì cliccate 
sul pulsante Add Library... e selezionate per l'ap- 
punto Standard Widget Toolkit (SWT), ignorando 
per adesso l'opzione relativa al supporto per JFace 
(Fig. 8). In questo modo avremo a disposizione tutti 
i package e le classi necessarie per sviluppare appli- 
cazioni SWT. Creiamo dunque la nostra classe prin- 
cipale, che offrirà anche la finestra iniziale con le 
opzioni di base. Dal menu File, o cliccando sempre 
col destro sul progetto, selezioniamo New->Visual 
Class (se necessario passate per Other. . . per avere la 
lista completa degli elementi disponibili: ricordate 
che i menu di Eclipse sono contestuali e dipendono 
quindi dalla prospettiva). Configurate così la nuova 
classe: nome del package "fedmest.eclipse.pdfgen", 
nome della classe "MainWin", lo stile "SWT->Appli- 
cation" e selezionate la spunta di creazione del me- 
todo mairi. Il metodo mairi generato contiene già 
codice necessario alla creazione della finestra prin- 
cipale, la cui sostanza (seppur con variazione sul 
tema) è la seguente: 

public static void main(String [] args) { 
Display display = new DisplayQ; 
Shell shell = new Shell(display); 
shell.open(); 

while (!shell.isDisposed()) { 
if (!display.readAndDispatch()) 
display.sleep(); } 

display.disposeQ; 

} 

Il Display rappresenta una sessione di lavoro SWT 
ed è responsabile per la comunicazione con il siste- 
ma operativo sottostante. Una delle sue funzioni più 
importanti è quella di riprodurre il ciclo degli eventi 
della piattaforma di esecuzione e riportarlo all'inter- 
no del codice Java (il blocco while del metodo mairi 
qui sopra). Tipicamente, ogni applicazione ha biso- 
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gno di un solo Display. La Shell invece è una finestra 
aperta direttamente sul desktop del sistema operati- 
vo: è una finestra principale se il parent è il Display, 
viene detta invece secondaria se parent è un'altra 
Shell. 

Passiamo adesso alla creazione visuale del nostro 
form. Non ci sono differenze enormi rispetto a 
quanto detto per Swing, cambiano però i layout a 
disposizione: SWT offre un layout nuli (basato su 
posizionamento e dimensionamento statici), un 
FillLayout (gli elementi hanno la stessa dimensione 
ed occupano tutto lo spazio libero disposti in una 
sola riga o colonna), un RowLayout (elementi dispo- 
sti per righe o colonne con varie opzioni), un Grid- 
Layout (elementi disposti in una griglia) e un Form- 
Layout (il più flessibile, ma senza supporto visuale in 
VEP per adesso). Io ho scelto GrìdLayout, che sele- 
ziono per la proprietà Layout nella view "Properties": 
è richiesto di preimpostare il numero di colonne (a 
differenza del GridBagLayout di Swing), cosa che 
possiamo fare nella stessa view, o nella finestra Cu- 
stomize Layout (Fig. 9), raggiungibile tramite l'omo- 
nimo menu contestuale sul form. La vostra finestra 
completa dovrebbe assumere una forma simile a 
quella di figura form. 



Customìze Layout - sShell-"PDF Generator" 



Layout | Component | 
[-Grid Columns — 
Number of columns: |4 ^j 



W Make columns equal width 



-5pacing — 

Horizontal spacing: | 5 ^j 
Vertical spacing: |5 ^j 
Margin width: H_§__1^B 
Margin height: H_§__)^S 



Fig. 9: Dialog di configurazione del layout e dei dati di 
layout di ogni componente 




Genera il file PDF 



Fig. IO: Il nostro form iniziale per l'applicazione di 
generazione di PDF 



Aggiungiamo ancora gli eventi widgetSelected (il 
click per farla breve) ai tre pulsanti che abbiamo 
messo sul form: per adesso, l'unico evento che im- 
plementeremo è quello del tasto di scelta file, che 
avrà il codice seguente, nel quale, come potete im- 
maginare, FileDialog è una classe SWT che richiama 
la dialog box di selezione file del sistema operativo: 

public void widgetSelected( 

org. eclipse. swt.events.SelectionEvent e) { 
FileDialog dlg = new FileDialog(sShell); 
String filename = dlg.open(); 



if ( filename != nuli ) 
text.setText(filename); } 

Adesso siamo pronti per vedere il nostro form in 
azione. Per eseguire il codice Java di un'applicazione 
SWT, però, abbiamo ancora bisogno di configurare il 
percorso della libreria nativa specifica di Windows. 
Se ricordate, infatti, abbiamo detto che uno strato di 
SWT fa chiamate ad una 
.dll {.so per Linux e così 
via) scritta appositamen- 
te per il sistema operati- 
vo di destinazione: ecco 
allora che dobbiamo 
passare alla JVM il per- 
corso di tale libreria di- 
namica affinché SWT 
funzioni. Aprite il dialog 
del menu Run... e ag- 
giungete questo valore 
alla casella di testo "VM 
Arguments" di una nuova 
configurazione per l'ese- 
cuzione di applicazioni 
Java 




Q 







| "^ 



Fig. 11: Impostazione del percorso della libreria nati- 
va SWT per la JVM di test di Eclipse 



-Djava. libra ry.path="D:\eclipse\plugins\ 

org. eclipse. swt.win32_3.0.0\os\win32\x86" 

sostituendo il percorso D:\eclipse con quello effetti- 
vo di installazione di Eclipse sulla vostra macchina 
(vedi Fig. 11). Adesso la vostra applicazione è pronta 
per essere eseguita! 



CONCLUSIONI 

Per oggi terminiamo qui il nostro lavoro. Abbiamo 
già messo molta carne al fuoco, se tenete conto del 
fatto che SWT è un intero sistema di gestione di 
interfacce per Java. 

Approfonditene lo studio perché ne vale la pena: 
Eclipse è un esempio di quanto efficace, performan- 
te e "visually appealing" 
questa nuova API possa 
essere. Nella prossima 
parte porteremo avanti 
la nostra applicazione di 
generazione di PDF: par- 
leremo di FormLayout, 
decisamente il più flessi- 
bile ed interessante tra 
quelli proposti da SWT, e 
predisporremo un form 
per chiedere all'utente 
cosa vuole vedere sul file 
PDF generato. 

Federico Mestrone 




CONTATTA 
L'AUTORE 



DOMANDE? 

Se avete bisogno di 
qualche aiuto, potete 
scrivermi a 
federico.mestrone® 
ioproqrammo.it 
Anche se la risposta 
può farsi attendere 
molto, soprattutto 
quando sono sotto 
stress, normalmente 
arriva sempre! 




APRIRE I PROGETTI ALLEGATI 

In allegato all'articolo trovate tutto il work- 
space utilizzato per creare le applicazioni di 
esempio. Potete aprirlo estraendo il file .zip 
e selezionando la cartella workspace 
risultante come nuovo ambiente di lavoro 
tramite il menu File->Switch Workspace.... 
Alternativamente potete importare i singoli 
progetti che si trovano sotto la cartella 
indicata (in questo caso JavaDevWithEclipse 
o PdfGeneratorWithEclipse) tramite il menu 
Import... con origine dati Existing Project 
into Workspace. 
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Il namespace System. IO 



File: input e output 

In questo appuntamento descriveremo le classi messe 

a disposizione da VB.NET che permettono di leggere e scrivere 

su file: indispensabile per qualsiasi progetto 
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Nel modulo Control- 
Chars sono disponibili 
costanti utilizzate co- 
me caratteri di control- 
lo che possono essere 
inserite in qualsiasi 
punto del codice. In 
particolare la costante 
ControlChars.CrLf rap- 
presenta la combina- 
zione di ritorno a capo 
e avanzamento riga 
(Chr(13) + Chr(IO)). 




S Elementi Visual Basic 
- ' .NET acquisiti nel corso 



Windows 2000/XP, 
VisualBasic.NET 




La classe Stream è una classe astratta che per- 
mette di gestire una generica sequenza di byte 
(flusso) nelle operazioni di input/ output. Uno 
Stream è un flusso di byte che può essere, di volta in 
volta, identificato con un oggetto diverso: un file, 
una periferica di input/output, un canale di comu- 
nicazione tra processi, o ancora un socket TCP/IP 
L'utilizzo della classe Stream fornisce al programma- 
tore un mezzo per gestire la lettura e l'invio di dati 
tra il programma e la periferica, senza che questi si 
debba preoccupare di come sia realizzato il collega- 
mento tra dati e periferiche. Esistono stream per le 
diverse entità di memorizzazione (stream per file, 
stream di memoria, stream di rete, ecc.). 
Sugli stream è possibile eseguire tre operazioni fon- 
damentali: lettura, scrittura e ricerca. 

• La lettura consiste nel trasferire informazioni 
da un generico flusso ad una struttura di dati, 
ad esempio una matrice di byte (come vedre- 
mo in seguito). 

• Con la scrittura possiamo trasferire informa- 
zioni da una struttura di dati ad un flusso. 

• La ricerca consiste nella richiesta, ed eventuale 
modifica, della posizione corrente di uno spe- 
cifico gruppo di byte all'interno di un flusso. 

Non tutti i tipi di stream, tuttavia, offrono supporto 
a tutte e tre le operazioni fondamentali. Per verifica- 
re le operazioni permesse, è possibile utilizzare le 
proprietà: 

• CanRead restituisce True se il flusso supporta la 
lettura. 

• CanWrite restituisce True se il flusso supporta la 
scrittura. 

• CanSeek restituisce True se il flusso supporta la 
ricerca. 

Altre proprietà e metodi interessanti sono: 

• Length restituisce la lunghezza dello Stream 
in byte. 

• Position restituisce la posizione corrente all'in- 



terno dello stream (Il punto di partenza delle opera- 
zioni di lettura o scrittura). 

• Il metodo Seek permette di riposizionare il pun- 
tatore all'interno dello stream, è quindi possibile 
muoversi avanti e indietro lungo uno stream per sta- 
bilire il nuovo punto di partenza delle successive 
operazioni di lettura o scrittura. 

• Il metodo SetLength permette di modificare la 
lunghezza dello Stream rendendolo pari al valore 
passato come argomento. Se valore indicato è 
minore della lunghezza dello stream, allora lo 
stream viene troncato. Se il valore indicato è mag- 
giore della lunghezza dello stream, allora lo stream 
viene esteso. 

• II metodo Read legge una sequenza di byte, della 
lunghezza indicata, a partire dalla posizione iniziale 
specificata come argomento. Ha come effetto di far 
avanzare il puntatore allo Stream. Si può utilizzare 
anche il metodo ReadByte che, però, legge e restitui- 
sce un singolo byte. 

• II metodo Write scrive un numero di byte, della 
lunghezza indicata, a partire dalla posizione iniziale 
specificata come argomento. Anche questo metodo 
fa avanzare il puntatore allo Stream. Si può utilizzare 
anche il metodo WriteByte che, però, scrive un unico 
byte. 

• II metodo Close chiude lo stream e libera tutte le 
risorse di sistema associate. Se si compie una opera- 
zione su un flusso chiuso, in seguito ad una chiama- 
ta a Close, VB.Net potrebbe generare un'eccezione. 
Se il flusso è già chiuso, una successiva chiamata al 
metodo Close, non genera eccezioni. 

• Il metodo Flush permette di svuotare uno Stream 
memorizzato in un buffer ed assicura che tutto il 
relativo contenuto sia scritto nel corrispondente 
dispositivo fisico. Il metodo Flush non ha alcun effet- 
to sugli stream non bufferizzati. 

Come accennato in precedenza, la classe Stream è 
una classe astratta, pertanto non è possibile creare 
direttamente un oggetto Stream e, di conseguenza, 
vi troverete raramente ad utilizzare una variabile 
Stream all'interno del codice, mentre utilizzerete più 
spesso classi, che derivano da Stream. 
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Le classi che derivano da Stream, implementano 
ulteriori metodi e proprietà, peculiari dell'entità di 
memorizzazione che rappresentano. Ad esempio, la 
classe FileStream, che permette di accedere ai file 
(comprese le periferiche standard di input, output 
ed errore), espone la proprietà Handle che restitui- 
sce l'handle del file di sistema operativo (gli handle 
sono dei descrittori numerici, ciascuno associato ad 
un file aperto, che il programma utilizza per effet- 
tuare le operazioni di scrittura, lettura e posiziona- 
mento) ed i metodi Lock e Unlock che permettono di 
bloccare o sbloccare una parte del file. La classe Fi- 
leStream utilizza, inoltre, le enumerazioni FileAccess, 
FileMode e FileShare che rappresentano i flag utiliz- 
zati dai costruttori della classe FileStream e determi- 
nano la modalità con cui viene creato, aperto e con- 
diviso un file. 



A DATI 
STRUTTURATI 

Abbiamo visto come il generico oggetto Stream sia 
in grado di leggere e scrivere byte singoli o gruppi di 
byte, ma, nei casi reali, si rende necessario poter leg- 
gere e scrivere dati strutturati, come una riga di testo 
o un numero. Per questo scopo, VB.Net mette a di- 
sposizione degli oggetti ausiliari più specializzati, in 
particolare: 

• Le classi BinaryReader e BinaryWriter permet- 
tono di leggere e scrivere dati primitivi, come un 
numero intero o una stringa codificata, in formato 
binario. 

• Le classi StreamReader e StreamWriter permet- 
tono di leggere e scrivere stringhe di testo in forma- 
to ANSI, come quelle che sono lette o scritte in un fi- 
le di testo. A differenza di BinaryReader e BinaryWri- 
ter, le informazioni sono trattate come testo piutto- 
sto che come dati binari. 

• TextReader e TextWriter sono classi astratte che 
definiscono le modalità di utilizzo delle stringhe di 
testo in formato Unicode. Le classi StiingReader e 
StringWriter derivano da TextReader e TextWriter. 

Riassumendo: la classe Stream è stata progettata per 
l'input e l'output dei byte, TextReader e TextWriter 
sono stati progettati per l'input e l'output di caratte- 
ri, BinaryReader e BinaryWriter sono stati progettati 
per la lettura e scrittura dei tipi primitivi in modalità 
binaria (anziché testo). 



DA UHI FILE DI TESTO 

Per leggere da un file di testo si può utilizzare un og- 
getto StreamReader. La classe StreamReader utilizza 



una codifica per convertire le matrici di byte in strin- 
ghe di caratteri. Come impostazione predefinita vie- 
ne utilizzata la codifica UTF-8 (per gli altri tipi di co- 
difica, vi rimando al box a lato). Questa classe espo- 
ne dieci costruttori in overload, alcuni dei quali con- 
sentono di rilevare automaticamente la codifica di 
un file oppure di specificarla come parametro. Esi- 
stono, pertanto, diversi modi per ottenere un riferi- 
mento ad un oggetto di questo tipo, ad esempio: 

• Si può creare un oggetto FileStream con il meto- 
do Open della classe File (descritta nell'articolo pre- 
cedente). Ricordiamo che metodo Open apre un 
oggetto FileStream, nel percorso specificato e con le 
modalità di accesso passate come argomento. Dopo 
aver creato l'oggetto di tipo FileStream si deve pas- 
sarlo, come argomento, al metodo costruttore dello 
StreamReader 

Dim OggettoStream As FileStream = File.Open( 

"C:\MioFile.txt", FileMode. Open, 

FileAccess. Read Write, FileShare. Read Write) 

Dim LeggiStream As New StreamReader(OggettoStream) 

• Si può creare un oggetto FileStream utilizzando il 
costruttore e, quindi, passarlo al metodo costruttore 
dello StreamReader: 

Dim OggettoStream As New FileStream( 

"C:\MioFile.txt", FileMode. Open) 

Dim LeggiStream As New StreamReader(OggettoStream) 

• Si può passare al costruttore il percorso comple- 
to del file da leggere: 

Dim LeggiStream As New StreamReader("c:\MioFile.txt") 

• Si può passare al costruttore il percorso comple- 
to del file e la codifica dei caratteri da utilizzare: 

Dim LeggiStream As New StreamReader( 

"c:\MioFile.txt", System. Text. Encoding. ASCII) 

• Si può passare al costruttore il percorso comple- 
to del file, lasciando al sistema il compito di rilevare 
la codifica: 

Dim LeggiStream As New StreamReader( 

"c:\MioFile.txt", True) 

Dopo aver ottenuto un riferimento all'oggetto 
StreamReader, è possibile utilizzare uno dei metodi 
messi a disposizione, che permettono di leggere uno 
o più caratteri per volta oppure un'intera riga di te- 
sto. 

• Il metodo Peek restituisce il codice del successi- 
vo carattere disponibile nello stream senza utilizzar- 




Per mantenere il codice 
il più compatto 
possibile, si può 
utilizzare l'istruzione 
Imports che semplifica 
l'accesso alle classi, 
eliminando la 
dichiarazione in modo 
esplicito il nome 
completo del 
namespace che le 
contiene. Le istruzioni 
Imports devono 
sempre essere scritte 
nella parte superiore 
del file nel quale 
volete utilizzarle, 
prima di qualunque 
altro codice. 
In tutti gli esempi di 
codice, si dà per scon- 
tato l'inserimento 
della seguente istruzio- 
ne Imports: 

Imports System. IO 
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Una riga è definita 

come una sequenza di 

caratteri seguita da un 

avanzamento riga 

( "\n ") o da un ritorno a 

capo immediatamente 

seguito da un 

avanzamento riga 

("\r\ii"). 



La maggior parte degli 

oggetti stream 

memorizza i dati in un 

buffer. Ad esempio, 

quando si scrive in uno 

stream di file, i dati 

non vengono scritti 

subito su disco ma 

vengono memorizzati 

in un buffer ed inviati 

al file alla chiusura 

dello stream oppure 

quando si invoca il 

metodo Flush. 



lo effettivamente. Nel caso in cui non esistano più 
caratteri nello stream, Peek restituisce il valore spe- 
ciale -1. 

Questo metodo viene utilizzato come test sul valore 
-1 per verificare la condizione di end-of-file. 

• Il metodo ReadLine consente di leggere un'inte- 
ra riga di caratteri dal flusso in esame. 

• Il metodo Read consente di leggere un carattere 
per volta. Questo metodo, legge il carattere succes- 
sivo e fa avanzare di un carattere la posizione cor- 
rente. 

• Il metodo ReadToEnd permette di leggere tutti i 
caratteri rimanenti, dalla posizione corrente fino 
alla fine del flusso. Se la posizione corrente corri- 
sponde con la fine del flusso, restituisce una stringa 
vuota (""). 

• Il metodo Close chiude l' oggetto StreamReader e 
libera tutte le risorse di sistema. 



IcAmiofili 



e.txt 



Leggi 



Un saluto 
ai lettori di 
loPrograrnrno 



Fig. 1: Il risultato della nostra applicazione di esempio 

A questo punto abbiamo tutti i mezzi per scrivere 
una applicazione che legga tutte le righe di testo 
presenti in un file, e le mostri in una finestra. Dopo 
aver creato una nuova applicazione Windows, nella 
finestra di progettazione dovremo inserire: 

• Una casella di testo (TextBoxPathFile) in cui l'u- 
tente dovrà scrivere il percorso completo del file da 
leggere. 

• Una casella di testo (TextBoxRisultato) multiRi- 
ga (con la proprietà MultiLine pari a True) , in cui sa- 
rà mostrato il contenuto del file. 

• Un pulsante (ButtonLeggi) che avvia la lettura e 
valorizza la casella di testo con il risultato di lettura. 

Il codice necessario dovrà essere scritto, ovviamen- 
te, nell'evento ButtonLeggi_Click: 

Private Sub ButtonLeggi_Click(ByVal sender 

As System. Object, ByVal e As System. EventArgs) 
Handles ButtonLeggi. Click 
'Apertura del file e creazione dell'oggetto StreamReader 
Dim OggettoStream As FileStream = File.Open( 

TextBoxPathFile.Text, FileMode.Open, 
FileAccess.ReadWrite, FileShare.ReadWrite) 
Dim LeggiStream As New StreamReader( 

OggettoStream) 
'dichiarazione della variabile che memorizza 

il testo letto 



Dim Contenuto As String 
'ciclo fino alla fine del file 
While LeggiStream. Peek <> -1 

'concate na le righe di testo aggiungendo il 

carattere di fine riga 
Contenuto = Contenuto + 

LeggiStream. ReadLine + ControlChars.CrLf 

End While 

'Ricordatevi di Chiudere sempre uno StreamReader 
LeggiStream. Close() 
'visualizza il risultato nel TextBox 
TextBoxRisultato.Text = Contenuto 
End Sub 

Nel caso in cui il file non esista, viene generata 
un'eccezione del tipo: System.IO.FileNotFoundEx- 
ception. Se, invece di leggere una riga per volta, vo- 
gliamo leggere l'intero contenuto del file in un colpo 
solo, possiamo sostituire il ciclo While, ed il codice al 
suo interno, con l'istruzione: 

Contenuto = LeggiStream. ReadToEnd 



SCRIVERE 

IH! UHI FILE DI TESTO 

Per scrivere in un file di testo si può utilizzare l'og- 
getto StreamWriter. Come nel caso di StreamReader, 
esistono molti modi per creare un oggetto Stream- 
Writer: 

• Si può creare un oggetto FileStream con il meto- 
do Open della classe File e passarlo al metodo co- 
struttore dello StreamWriter: 

Dim OggettoStream As FileStream = File.Open( 

"C:\Nuovofile.txt", FileMode. Create, 
FileAccess.ReadWrite, FileShare.None) 
Dim ScriviStream As New StreamWriter( 

OggettoStream) 

• Si può creare un oggetto FileStream utilizzando 
costruttore e, quindi, passarlo al metodo costruttore 
dello StreamWriter: 

Dim OggettoStream As New FileStream( 

"C:\Nuovofile.txt", FileMode.Open) 
Dim ScriviStream As New StreamWriter( OggettoStream) 

• Si può passare al costruttore il percorso comple- 
to del file da scrivere, utilizzando le dimensioni del 
buffer e la codifica predefinite: 

Dim ScriviStream As New StreamWriter("C:\Nuovofile.txt") 

• Si può passare al costruttore percorso comple- 
to del file da scrivere ed un parametro, append, che 
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determina se i dati devono essere aggiunti al file. Se il 
file esiste ed il parametro appena è false, il file viene 
sovrascritto. Se il file esiste ed il parametro appena è 
true, i dati vengono aggiunti. Infine, nel caso in cui il 
file non esiste, costruttore crea un nuovo file: 

Dim ScriviStream As New StreamWriter( 

"C:\Nuovofile.txt", True) 



La classe BinaryReader espone numerosi metodi 
Read (ReadBoolean, ReadChar, ReadDecimal, Read- 
Doublé. . . .), uno per ogni possibile tipo di dato nati- 
vo, ed un metodo PeekChar che restituisce -1 nel 
caso in cui non esistono più caratteri nello stream. 
Se vogliamo riscrivere la nostra applicazione di 
esempio utilizzando BinaryReader, il codice sarà 
molto simile a quello scritto in precedenza: 




La classe StreamWrìter espone due metodi che per- 
mettono di scrivere in un file di testo: 

• Il metodo Write permette di scrivere la rappre- 
sentazione testuale di tutti i tipi primitivi di VB.Net 
(Boolean, Integer, Doublé, ..). 

• Il metodo WriteLine, rispetto al metodo Write, 
aggiunge automaticamente un carattere di nuova ri- 
ga. Il terminatore di riga predefinito è un ritorno a 
capo seguito da un avanzamento riga ("\r\n"). 

Possiamo, ora, scrivere il codice che ci permetterà di 
leggere un file e di crearne uno nuovo, con lo stesso 
contenuto. Ovviamente avremo bisogno di un og- 
getto StreamReader per leggere il file e di un oggetto 
StreamWrìter per scrivere il nuovo file. Il secondo 
passo sarà quello di ciclare su tutte le righe del file di 
origine e di scrivere la riga, appena letta, nel file di 
destinazione. Infine chiuderemo i due oggetti 
StreamReader e StreamWrìter. 

Dim LeggiStream As New StreamReader("C:\MioFile.txt") 
Dim ScriviStream As New StreamWriter("C:\NuovoFile.txt") 
While LeggiStream. Peek <> -1 

Seri viStream.WriteLine( LeggiStream. ReadLine) 

End While 

LeggiStream. Close() 
ScriviStream. Close() 



LEGGERE E SCRIVERE 
FILE BINARI 

Le classi BinaryReader e BinaryWriter permettono di 
leggere e scrivere stringhe e dati di tipo elementare 
in un file. A differenza di StreamReader e StreamWrì- 
ter, le informazioni vengono lette e scritte come dati 
binari e non come testo, inoltre non si possono crea- 
re degli oggetti BinaryReader o BinaryWriter passan- 
do direttamente al costruttore il nome di un file. Per 
creare, quindi, un oggetto BinaryReader o Binary- 
Writer, si deve generare esplicitamente un oggetto 
Stream e passarlo, come argomento, ai metodi co- 
struttori della classe, per questo possiamo scrivere 
ad esempio: 

Dim OggettoStream As Stream = File.Open( 

"c:\miofile.txt", FileMode.Open, FileAccess.Read) 
Dim LeggiBinario As New BinaryReader(OggettoStream) 



'Apertura del file e creazione dell'oggetto BinaryReader 

Dim OggettoStream As Stream = File.Open( 

TextBoxPathFile.Text, FileMode.Open, FileAccess.Read) 

Dim LeggiBinario As New BinaryReader(OggettoStream) 

Dim Contenuto As String 

'Itera fino a che vi sono dati a disposizione 

While LeggiBinario. PeekChar <> -1 

'Legge l'elemento successivo e concatena il risultato 
Contenuto = Contenuto + LeggiBinario. ReadChar 

End While 

'chiudiamo gli oggetti aperti 

LeggiBinario. Close() 

OggettoStream. Close() 

'visualizza il risultato nel TextBox 

TextBoxRisultato.Text = Contenuto 

L'utilizzo dell'oggetto BinaryWriter, è molto affine al- 
l'oggetto StreamWrìter, poiché il relativo metodo 
Write subisce l'overloading in modo da accettare 
tutti i tipi primitivi diVB .NET. Se vogliamo riscrive- 
re il codice di esempio che ci permette di leggere un 
file e di crearne uno nuovo (con lo stesso contenu- 
to), utilizzando BinaryWriter, si avrà semplicemente: 

Dim StreamlnLettura As Stream = File.Open( 

"c:\Miofile.txt", FileMode.Open, FileAccess.Read) 
Dim StreamlnScrittura As Stream = File.Open( 

"c:\Nuovofile.txt", FileMode. Create, 

FileAccess.Read Write, FileShare.None) 

Dim LeggiBinario As New BinaryReader(StreamlnLettura) 

Dim ScriviBinario As New BinaryWriter(StreamlnScrittura) 

While LeggiBinario. PeekChar <> -1 

Seri viBinario.Write(Leggi Bina rio. ReadChar) 

End While 

LeggiBinario. Close() 
ScriviBinario. Close() 

L'uso di BinaryWriter e BinaryReader per scrivere 
e leggere stringhe presenta però alcune proble- 
matiche. Quando si passa una stringa al metodo 
Write viene creata una stringa di lunghezza prefis- 
sata. Se si vogliono scrivere soltanto i caratteri 
effettivi, è necessario passare al metodo Write una 
matrice di Chars. Per leggere stringhe si possono 
utilizzare due metodi: il metodo ReadString, nel 
caso di stringhe di lunghezza prefissata oppure il 
metodo ReadChar nel caso di stringhe a lunghez- 
za fissa. 

Luigi Buono 



FileMode permette di 
indicare le modalità di 
apertura di un file. 



FileAccess permette di 
indicare le modalità di 
accesso in lettura e 
scrittura di un file. 

FileShare permette di 
indicare il tipo di 
accesso al file di cui 
dispongono altri 
thread aperti. 



La classe ASCI/Enco- 
ding codifica i caratteri 
Unicode come caratteri 
ASCII singoli a 7 bit. 

La classe UnicodeEnco- 
ding codifica ciascun 
carattere Unicode 
come due byte 
consecutivi. 

La classe UTF7Encoding 
codifica i caratteri 
Unicode utilizzando la 
codifica UTF-7 (UTF-7 
indica UCS Transforma- 
tion Format, form a 7 
bit). 

La classe UTF8Encoding 
codifica i caratteri 
Unicode utilizzando la 
codifica UTF-8 (UTF-8 
indica UCS 

Transformation Format, 
form a 8 bit). 
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Attributi e uso dei puntatori nei blocchi di codice unsafe 

Attributi e codice 
unsafe 



ultima parte 

Giungiamo alla trentesima ed ultima lezione di questo corso 
dedicato a C#. Oggetto di studio dell'appuntamento finale saranno 
gli attributi, il codice unsafe ed i puntatori 
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Questa che state leggendo è l'ultima 
puntata del corso di C# che ioPro- 
grammo sta pubblicando da oltre due 
anni. Siamo dunque arrivati agli ultimi argo- 
menti, che rappresentano alcune fra le carat- 
teristiche più peculiari del linguaggio. 



ATTRIBUTI 

C# prevede la possibilità di aggiungere ulte- 
riori informazioni al codice attraverso degli 
elementi sintattici chiamati attributi. Grazie 
agli attributi è possibile associare delle infor- 
mazioni ad una classe, ad un metodo, ad una 
struttura e via discorrendo. A seconda dello 
scopo e della funzionalità dell'attributo uti- 
lizzato, la struttura sintattica cui ci si riferi- 
sce avrà un comportamento diverso in fase 
di compilazione o di esecuzione. C# dispone 
di un set di attributi predefiniti, due dei quali 
saranno esaminati in questa lezione. Il pro- 
grammatore può poi arricchire il set fornito 
realizzando degli attributi personalizzati. 
Tutti gli attributi precedono la struttura sin- 
tattica cui si riferiscono, e la loro forma è la 
seguente: 

[NomeAttributo(parametri)] 

L'attributo Conditional 

L'attributo Conditional, in parole semplici, 
fornisce una scorciatoia per la compilazione 
condizionale esaminata nel corso della lezio- 
ne precedente (direttive #if, #elif, #else e #en- 
dif). Per poter far ricorso all'attributo Con- 
ditional è necessario importare il namespace 
System. Diagnostics mediante una clausola 
using. L'utilizzo dell'attributo Conditional 



viene dimostrato attraverso il seguente co- 
dice esemplificativo: 



#define PROVAI 


#define PROVA2 


using System; 


using System. Diagnostics; 


class Test { 


[Conditional("PROVAl")] 


public void proval() { 


Console. Writel_ine("Sono i 


metoc 


o provai' 


); 


} 


[Conditional("PROVA2")] 


public void prova2() { 


Console. Writel_ine("Sono i 


metoc 


o prova2' 


); 


} 


public static void Main() { 


Test t = new Test(); 


t.proval(); // Richiamato solo se 


PROVAI è 


definito 


t.prova2(); // Richiamato solo se 


PROVA2 è 


definito 


} 


} 



Il codice definisce due simboli: PROVAI e 
PROVA2. Il metodo provalo sarà eseguito 
soltanto se il simbolo PROVAI risulterà defi- 
nito; alla stessa maniera prova2() sarà ese- 
guito solo nel caso in cui sarà stata riscontra- 
ta la definizione del simbolo PROVA2. Prova- 
te pertanto a variare le due definizioni inizia- 
li per verificare il funzionamento dell'attri- 
buto Conditional. 

L'attributo Obsolete 

L'attributo Obsolete è utile per marcare come 
obsoleta una struttura del codice. Che utilità 
può avere questo genere di operazione? Sup- 
poniamo di aver realizzato una libreria di 
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classi utili per compiere una certa serie di 
operazioni. Queste classi, naturalmente, di- 
spongono di metodi che sono invocati dai 
programmatori che fanno uso della nostra 
libreria. A distanza di qualche tempo deci- 
diamo di revisionare la nostra libreria di clas- 
si al fine di pubblicarne una nuova versione, 
con prestazioni migliorate e con nuove carat- 
teristiche aggiunte. 

In questo processo di revisione stabiliamo 
che alcuni metodi presenti nella prima relea- 
se non dovrebbero più essere utilizzati, ma- 
gari perché abbiamo cambiato l'approccio di 
alcune parti della libreria. Rimuovere total- 
mente i metodi obsoleti è una soluzione er- 
rata: la nuova versione della nostra libreria 
non sarebbe così retrocompatibile con la 
precedente, e per questo non potrebbe esse- 
re usata in corrispondenza di codice scritto 
prima della sua pubblicazione. Allo stesso 
tempo, però, si desidera far osservare ai pro- 
grammatori che fanno uso della libreria di 
non utilizzare più, d'ora in poi, alcuni dei 
metodi in essa compresi. A questo scopo è 
possibile servirsi dell'attributo Obsolete. 
Il modello cui far riferimento è il seguente: 

[Obsolete("messaggio")] 

Ecco un esempio dimostrativo: 

using System; 

class Test { 

[Obsolete("Non usare questo metodo! Usa dividi2")] 
public int dividi(int a, int b) { 
return a / b; 

_} 

public int dividi2(int a, int b) { 

if (b == 0) return 0; 

else return a / b; 
_} 

public static void Main() { 

Test t = new Test(); 

// Alla compilazione mostra un avvertimento. 

Console. WriteLine("10 / 2 = " + t.dividi(10, 2)); 

// Nessun avvertimento. 

Console. WriteLine("10 / 2 = " + t.dividi2(10, 2)); 
} 



Il metodo divìdìQ è marcato come obsoleto, 
rimpiazzato da dividi2(). Nonostante questo 
nel MainQ si fa ricorso a dividiQ. La compila- 



zione riuscirà tranquillamente, ma il compi- 
latore avrà cura di mostrare in output un 
messaggio di avvertimento come il seguente: 

Esempio02.cs(18,37): warning CS0618: 

"Test.dividi(int, int)" è obsoleto: "Non usare questo 

metodo! Usa dividi2" 



CODICE UHISAFE 

C# permette l'uso di codice unsafe, cioè insi- 
curo. Con la dicitura codice insicuro non si 
intende del codice mal scritto: la bontà del 
codice dipende esclusivamente dal program- 
matore! I compilatori accettano qualunque 
cosa sia sintatticamente corretta, e purtrop- 
po ancora deve essere inventato un compila- 
tore capace di distinguere un codice ben 
scritto in ogni particolare da uno insicuro a 
causa dell'inesperienza del programmatore. 
In principio di questo corso si è spiegato 
come i programmi per .NET siano eseguiti 
all'interno di uno speciale ambiente chiama- 
to CLR (Common Language Runtime). Il CLR 
gestisce la memoria, aumentando la robu- 
stezza del software realizzato e sollevando il 
programmatore da alcune gravose responsa- 
bilità. Tuttavia, osservando l'altra faccia della 
medaglia, si capisce che queste buone carat- 
teristiche comportano anche lacune presta- 
zionali e diminuiscono il grado di libertà del 
programmatore. Benché sia un evento raro, 
può capitare che si abbia il desiderio o la 
necessità di escludere parte dei controlli del 
CLR, soprattutto per tornare a gestire diretta- 
mente la memoria come si fa con linguaggi 
quali C e C++. 

Insomma, per farla breve, si può aver biso- 
gno di tornare ai vecchi puntatori, croce e 
delizia della programmazione di più basso 
livello. C# permette di farlo, attraverso dei 
blocchi etichettati come insicuri, proprio 
perché eseguiti senza la supervisione del 
CLR. La responsabilità del buon uso della 
memoria, nei blocchi unsafe, cade di nuovo 
nelle mani del programmatore. 



UTILIZZO 

DEI PUNTATORI 

Questo paragrafo non ha la presunzione di 
voler spiegare in poche righe come si faccia 
uso dei puntatori a chi non ne ha mai sentito 
parlare; piuttosto si presenta come un pron- 
tuario per chi già ha programmato con altri 
linguaggi che ne fanno uso abbondante. 
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Un puntatore è una variabile che contiene 
l'indirizzo di memoria di un'altra variabile. 
Se la variabile a contiene l'indirizzo della va- 
riabile b si dice che "a punta a b". I puntatori 
si dichiarano al seguente modo: 

tipo* nome 

Ad esempio: 

int* a 

In un caso come quello appena mostrato il 
puntatore a potrà memorizzare l'indirizzo di 
una qualsiasi variabile di tipo int. È molto 
importante osservare che solo i tipi non- 
classe possono essere puntati in questa ma- 
niera. 

L'operatore unario & può ricavare l'indirizzo 
di una variabile esistente, in modo che lo 
stesso possa poi essere utilizzato, ad esempio 
proprio per memorizzarlo all'interno di un 
puntatore. Per questo motivo l'operatore & 
viene letto come "indirizzo di". 
Ecco un esempio: 

int a = 5; 
int* p = &a; 

In questo modo si otterrà un puntatore p che 
punterà alla variabile a. L'operatore unario * 
è complementare rispetto a &. Permette la 
lettura del valore memorizzato nella variabi- 
le puntata da un indirizzo di memoria. Per 
questo motivo l'operatore viene letto come 
"valore di". 
Proseguendo l'esempio precedente: 

int a = 5; 

int* p = &a; 

int b = *p; 

In questa maniera la variabile b riceve il valo- 
re della variabile puntata da p, cioè 5. 
I puntatori possono essere utilizzati anche in 
corrispondenza delle strutture: 



struct Rettangolo { 


public 


int larghezza; 








public 


int altezza; 








public 


int area() { return 


larghezza 


* altezza; 


} 


} 


Retta ng 


olo r = new Rettan 


golo(); 






Rettang 


Dio* p = &r; 









dell'operatore . (punto) utilizzato con le nor- 
mali variabili: 

p->larghezza = 5; 

p->altezza = 3; 

int area = p->area(); 



LA CLAUSOLA 
UHISAFE 

Per utilizzare i puntatori di C# è necessario 
specificare esplicitamente che si sta scriven- 
do del codice potenzialmente insicuro. 
La parola chiave necessaria è unsafe, che può 
essere utilizzata per etichettare una singola 
istruzione, un blocco oppure un intero meto- 
do: 

unsafe istruzione; 

unsafe { 
// blocco 

} 

unsafe public void metodo() { 
// metodo 

} 

Ecco un esempio: 

using System; 

class Test { 
unsafe public static void Main() { 
int a = 5; 
int* p = &a; 

*p += 2; 

Console. WriteLine(a); 



} 



I singoli campi di una struttura raggiunta 
mediante puntatore possono essere selezio- 
nati servendosi dell'operatore ->, al posto 



} 



I programmi che contengono delle porzioni 
unsafe vanno compilati al seguente modo: 

esc /unsafe NomeFile.cs 

Tutte queste accortezze servono per verifica- 
re che il programmatore sia realmente co- 
sciente di quel che sta facendo. 



LA CLAUSOLA FIXED 

C# dispone dunque di due differenti tecniche 
per la gestione della memoria: quella auto- 
matica, attuata dal CLR, e quella "manuale", 
svolta dal programmatore attraverso i punta- 
tori ed i blocchi di codice unsafe. Può capita- 
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re che le due tecniche vadano in conflitto, 
per via della garbage collection svolta dal 
CLR. Si ricorda che la garbage collection è il 
procedimento messo in atto dal CLR per ri- 
pulire la memoria dagli oggetti non più uti- 
lizzati e per ricompattare quelli rimanenti. 
Non è possibile sapere quando il CLR awierà 
la garbage collection. Per questo motivo può 
capitare che un puntatore rivolto al campo di 
un oggetto perda la propria consistenza. 
Supponiamo di avere la seguente classe: 



// codice che fa uso di p 



class Rettangolo { 


public 


int larghezza; 








public 


int altezza; 








public 


int area() { return larghezza 


* altezza; 


} 


} 



Inoltre, supponiamo poi di avere da qualche 
parte un codice come il seguente, che fa uso 
di puntatori: 

Rettangolo r = new Rettangolo(); 
int* p = &r.larghezza; 

//■■■ 

*p += 6; 

Può accadere che la garbage collection venga 
eseguita dopo la seconda istruzione, all'al- 
tezza del commento che vuole rappresentare 
l'eventuale presenza di altro codice non rela- 
zionato agli elementi mostrati. A seguito del- 
la garbage collection e della ricompattazione 
della memoria può accadere che l'oggetto r 
non si trovi più nella stessa area di memoria 
in cui era inizialmente. I puntatori, in un ca- 
so come questo, non vengono aggiornati au- 
tomaticamente. Allora p si ritroverà a punta- 
re un'area della memoria che non corrispon- 
de più al campo larghezza dell'oggetto r. Na- 
turalmente questo è un grave problema, sia 
perché il valore di p non può più essere letto 
con certezza di corrispondeza sia perché ag- 
giornando lo stesso si corre il rischio di com- 
promettere altri dati che dopo la garbage col- 
lection sono andati ad occupare la porzione 
di memoria che prima era dell'oggetto r. C# 
pone rimedio a questo problema con la clau- 
sola fixed, che permette di fissare un oggetto 
in memoria. Quando un oggetto è contrasse- 
gnato come fisso la garbage collection non lo 
sposterà per nessuna ragione dalla sua posi- 
zione in memoria. In questo modo i puntato- 
ri manterranno sempre la corretta corrispon- 
denza. L'uso della clausola avviene alla se- 
guente maniera: 

fixed (tipo* p = &oggetto. campo) { 



} 



Se la garbage collection dovesse essere lan- 
ciata durante l'esecuzione delle istruzioni 
presenti nel blocco, l'oggetto associato al 
puntatore non sarà spostato. Ecco un esem- 
pio pratico: 

using System; 

class Rettangolo { 

public int larghezza; 

public int altezza; 

public int area() { return larghezza * altezza; } 
} 

class Test { 
unsafe public static void Main() { 
Rettangolo r = new Rettangolo(); 
r.larghezza = 7; 
r. altezza = 3; 

fixed (int* p = &r.larghezza) { 
*p -= 2; 

} 

Console. WriteLine(r.area()); 

} 



} 



Ricordatevi di utilizzare sempre la clausola 
fixed ogni volta che vi troverete a gestire in- 
sieme puntatori ed oggetti. Gli errori derivati 
dal mancato utilizzo di fixed sono infatti dif- 
ficili da scovare, proprio perché capitano in 
situazioni particolari e rare. Il fatto che l'oc- 
correre di un errore sia raro, ad ogni modo, 
non rende l'errore stesso meno grave. 
E poi, si sa: se qualcosa può andare storto lo 
farà sempre al momento meno opportuno. 



CONCLUSIONI 

Siamo così giunti al termine dell'ultima 
lezione di questo corso. Mi auguro che lo 
abbiate seguito con piacere ed interesse, e vi 
auguro di diventare degli ottimi programma- 
tori C#. Di strada da fare ce n'è ancora molta, 
ma con solide nozioni di base apprendere le 
tecniche più avanzate è semplice e diverten- 
te. Dunque buon divertimento e alla prossi- 
ma, ricordatevi di non perdete i prossimi 
numeri di ioProgrammo, dove gli aspetti più 
pratici di C# troveranno lo spazio sufficiente 
per consentirvi il proseguimento dello studio 
intrapreso. 

Carlo Pelliccia 
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articolo scrivi a 

carlo.pelliccia® 
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Lanciare e gestire le eccezioni in Java 



Applicazioni 
più robuste 

Uno dei punti di forza di Java è un sistema robusto e affidabile per 
gestire gli errori. Questo mese imparerai cosa sono le eccezioni e 
come usarle: una tappa fondamentale verso applicazioni "robuste" 
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La gestione degli errori è una parte importante 
di Java, e non puoi usare il linguaggio se non 
conosci questi meccanismi. Questo articolo 
introdurrà l'argomento, e quello del mese venturo lo 
approfondirà. Ecco cosa ti aspetta: 

• Imparerai ad usare la parola chiave super. 

• Scoprirai cos'è un'eccezione. 

• Imparerai a lanciare e gestire le eccezioni. 

Prima di entrare nel vivo di questo articolo, però, vo- 
glio spiegarti qualcosa in più su un argomento di 
qualche mese fa: i costruttori. 



RITORNO 

Al COSTRUTTORI 

Guarda questa coppia di classi: 

public class ClasseBase { 
protected int x; 
public ClasseBase() { x = 10; 

System. out.println("ClasseBase( )");}} 
public class ClasseDerivata extends ClasseBase { 
public ClasseDerivata() { 

System. out.prìntln("ClasseDerivata()"); 

System. out.println("x vale " + x);} 
public static void main(String[] args) { 

new ClasseDerivata();} } 

Cosa succede se lanci ClasseDerivata.mainO ì . 

ClasseBaseQ 
ClasseDerivata() 
x vale 10 

Quando costruisci un oggetto, Java cerca prima di 
chiamare il costruttore della sua superclasse. Se non 
lo facesse, non avresti la garanzia che l'oggetto sia 



costruito correttamente. Nel nostro esempio, Classe- 
Derivata eredita il campo x di ClasseBase. Se il co- 
struttore di ClasseBase non venisse chiamato, questo 
campo non verrebbe inizializzato. Dato che Classe- 
Derivata potrebbe voler accedere a x (e in effetti lo 
fa), costruttore di ClasseBase deve essere chiamato 
il più presto possibile, prima di qualsiasi operazione 
sulla classe derivata. Java ottiene questo risultato 
aggiungendo all'inizio del costruttore di ClasseDeri- 
vata una chiamata "Invisibile" al costruttore di Clas- 
seBase. Se vuoi, puoi fare la stessa cosa in modo 
esplicito usando la parola chiave superQ: 

public class ClasseDerivata... 
public ClasseDerivata() { 
super(); 

System. out.println("ClasseDerivata()"); 
System. out.println("x vale " + x);} 

La chiamata a super deve sempre essere la prima 
operazione di un costruttore, pena un errore di 
compilazione. Se non scrivi esplicitamente superQ, 
Java aggiunge questa chiamata per conto proprio. 
Tutto questo avviene sempre, a patto che che la su- 
perclasse abbia un costruttore senza argomenti (ti 
ricordo che se non scrivi il costruttore, Java ne gene- 
ra silenziosamente uno senza argomenti e vuoto). 
Ora proviamo a sostituire il costruttore senza argo- 
menti di ClasseBase con uno che prende un argo- 
mento intero: 



public class ClasseBase { 


private int x; 


public ClasseBase(int parametro) { 


x = parametro; 




System. out.println("ClasseBase(" + 


parametro + ")"); 


}} 



A questo punto, ClasseDerivata non compila più. Il 
compilatore genera un errore simile a questo: 
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ClasseBase(int) in ClasseBase cannot be applied to () 

Proprio come prima, Java esige che il costruttore 
della ClasseBase venga chiamato all'inizio del co- 
struttore della ClasseDerìvata. Ma questa volta il co- 
struttore della ClasseBase richiede un argomento in- 
tero. Quindi Java non può invocare automaticamen- 
te il superO, perché non saprebbe quale valore dare 
a questo argomento. In casi come questo ci tocca 
chiamare esplicitamente il superO passandogli un 
valore intero: 

public class ClasseDerìvata... 
public ClasseDerivata() { 
super(lO); 
System. out.println("ClasseDerivata( 

" + parametro + ")");} 



mando al main() sotto forma di un array di stringhe. 
Esercizio 1: Scrivi un programma che stampa gli 
argomenti della sua riga di comando. Forse hai già 
risolto questo esercizio qualche mese fa. Ecco la 
soluzione: 

public class Argomenti { 

public static void main(String[] args) { 
for(int i = 0; i < args.length; i++) 
System. out.println(args[i]);} } 

Prova a lanciare questo programma con qualche ar- 
gomento: 

java it.ioprogrammo.corsojava. eccezioni. Argomenti a b e def 

Il risultato è in Fig. 1. 




Qui ho passato un valore qualsiasi, ma di solito è 
meglio lasciare che sia il client a decidere il valore 
dei parametri: 

public class ClasseDerìvata... 

public ClasseDerivata(int parametro) { 
super( parametro); 
System. out.println("ClasseDerivata( 

" + parametro + ")");} 
public static void main(String[] args) { 
new ClasseDerivata(lO);} 

Il risultato è: 

ClasseBase(lO) 
ClasseDerivata(l 0) 
x vale 10 

Riassumiamo: 

• Java vuole che il costruttore della classe base sia 
sempre chiamato per primo nel momento in cui 
si crea un oggetto della classe derivata; 

• se la classe base ha un costruttore senza argo- 
menti, Java aggiunge la chiamata automatica- 
mente. 

• se la classe base non ha un costruttore senza 
argomenti, o se la classe base ha più costruttori 
e vuoi decidere tu quale chiamare, allora devi 
farlo esplicitamente con la parola chiave super. 

• superO deve essere sempre la prima istruzione 
nel costruttore della classe derivata. 

Tutto questo tornerà utile tra poco. 



LINGUE SCONOSCIUTE 

Ecco finalmente il primo esercizio "corposo" di que- 
sto mese. Esercizio 2: Scrivi un programma che 
prende una stringa dalla riga di comando, conver- 
te tutte le vocali in 'i' e stampa la stringa sullo 
schermo. La mia soluzione: 



package it.ioprogrammo.corsojava. eccezioni 1; 
public class Cinesizzatore { 

public static void main(String[] args) { 
String originale = args[0]; 
System. out.println(cinesizza(originale));} 
private static String cinesizza(String originale) { 
String cinese = ""; 

for(int i = 0; i <= originale. Iength(); i++) 
cinese += cinesizza(originale.charAt(i)); 
return cinese;} 
private static char cinesizza(char e) { 

if(c == 'a' || e == 'e' 1 1 e == 'o' 1 1 e == 'u') 

return Y; 
return e;} } 

Il programma usa il metodo statico overloaded cine- 
sizzaO per convertire tutte le vocali in T. Una delle 
due varianti del metodo converte un singolo carat- 
tere, e l'altra usa la prima variante per convertire tut- 
ti i caratteri di una stringa. Esercizio 3: La mia solu- 
zione all'esercizio 1 ha diversi problemi. Trovane 
due. Ho usato due metodi della classe String: il me- 
todo String.lengthO restituisce la lunghezza della 
stringa; il metodo String. charAt(i) restituisce il ca- 
rattere di indice i delle stringa. Il primo problema 
salta fuori appena lanci programma: 




Fig. 1: 1 parametri sono 
restituiti correttamente 



BUONI ARGOMENTI 

Prima del nostro esempio, ti ricordo che la Java Vir- 
tual Machine passa gli argomenti della riga di co- 



java it.ioprogrammo.corsojava. eccezioni. Cinesizzatore 
"Non è bello ciò che è bello" 

Ecco lo sconfortante risultato: 
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ESERCIZIO 4 



Modifica il 

Cinesizzatore in modo 

che converta 

correttamente le vocali 

maiuscole (compresa la 

'e' maiuscola 

accentata, che è un 

carattere a sé stante). 



java.lang.StringlndexOutOfBoundsException: String index 
out of range: 27 at java. lang. String. charAt(Unknown 
Source) at it.ioprogrammo.corsojava. eccezioni. 
Cinesizzatore.cinesizza(Cinesizzatore.java:13) 
at it.ioprogrammo.corsojava. eccezioni. 

Cinesizzatore. main(Cinesizzatore.java: 7) 
Exception in thread "main" 

Purtroppo il mio codice contiene un bug, un errore 
di programmazione. Il metodo String.charAtQ usa le 
stesse convenzioni di un array: l'indice va da alla 
lunghezza della stringa meno 1. La stringa dell'e- 
sempio è lunga 27 caratteri, quindi gli indici vanno 
da a 26. Ma nel ciclo ho usato un "maggiore e 
uguale" al posto di un "maggiore", quindi nell'ulti- 
ma iterazione il programma cerca di referenziare il 
carattere di indice 27. Se fossi stato un po' più atten- 
to quando scrivevo codice, non sarei finito in que- 
sta situazione imbarazzante. Capita. Se avessi scritto 
il programma in un altro linguaggio, forse avrei ri- 
schiato di leggere un valore a casaccio dalla memo- 
ria. Per fortuna Java controlla tutti gli accessi indiciz- 
zati alle stringhe, quindi si accorge dell'errore e 
gestisce la cosa in modo elegante: lancia un'eccezio- 
ne. Un'eccezione è un oggetto che segnala che qual- 
cosa è andato storto durante l'esecuzione del pro- 
gramma. Le eccezioni sono istanze della classe Ex- 
ception, o di qualche sua sottoclasse. In particolare 
questo mese parleremo delle eccezioni unchecked, 
che sono istanze di RuntimeException, che a sua vol- 
ta è una sottoclasse di Exception. Nel nostro caso, 
una StringlndexOutOfBoundsException (una sotto- 
classe di RuntimeException) indica che il program- 
ma cerca di accedere fuori dai limiti della stringa. 
L'eccezione non si limita a segnalare il tipo di errore: 
dice anche dove si è verificato (alla riga 13 del 
Cinesizzatore), e quale è stata la sequenza di chia- 
mate che lo ha generato (è successo nel metodo 
String.charAtQ, chiamato a sua volta dalla riga 13 del 
metodo Cinesizzatore.cinesizzaQ, che era stato chia- 
mato dalla riga 7 del metodo Cinesizzatore .mainO). 
In più l'eccezione indica che il programma ha cerca- 
to di accedere al carattere di indice 27. Grazie a tutte 
queste informazioni posso capire facilmente dove 
ho sbagliato, e correggere il mio errore: 

public class Cinesizzatore... 

private static String cinesizza(String originale) 
{ String cinese = ""; 

for(int i = 0; i < originale. Iength(); i+ + ) 

cinese += cinesizza(originale.charAt(i)); 
return cinese; } 



IL GIOCO 

DELLA STAFFETTA 

Un'eccezione è come una palla, che una riga di pro- 



gramma (o la Virtual Machine in persona) lancia per 
segnalare un problema. Quando un metodo incon- 
tra un'eccezione, il normale flusso del programma si 
interrompe, e il controllo torna al client che ha chia- 
mato il metodo. Il chiamante potrebbe gestire l'ec- 
cezione (presto vedrai come). In caso contrario, an- 
che il chiamante si interrompe e a sua volta passa la 
palla al proprio chiamante, e così via. Come una pa- 
tata bollente, l'eccezione passa di mano in mano fin 
quando qualcuno non la gestisce, o fin quando il 
controllo non passa al primo di tutti i client: la 
Virtual Machine che ha chiamato il mainQ. Provia- 
mo a inventare un tipo di eccezione tutto nostro e a 
lanciarla. Come ti ho detto, tutte le eccezioni deriva- 
no da Exception, ma questo mese ci occuperemo in 
particolare di quelle che derivano da RuntimeExcep- 
tion, a sua volta una sottoclasse di Exception (il mese 
venturo parleremo più in dettaglio della gerarchia 
delle eccezioni): 

public class SimpaticaEccezione extends RuntimeException { 
public SimpaticaEccezione(String msg) { 
super(msg); } } 

RuntimeException ha più costruttori, incluso uno 
senza argomenti. Nel nostro caso ho invece chiama- 
to, con superO, il costruttore che prende una String. 
Questa stringa è un messaggio associato all'eccezio- 
ne. In questo modo l'eccezione può contenere, oltre 
alla descrizione generica del problema (la sua clas- 
se) anche eventuali dettagli specifici (il messaggio). 
Puoi lanciare un'eccezione con la parola chiave 
throw. Di solito si crea l'eccezione nel punto in cui la 
si lancia: 

throw new RuntimeException("messaggio"); 

Ecco un esempio: 

package it.ioprogrammo.corsojava. eccezioni 1; 
public class Staffetta { 

public static void main(String[] args) { 

a(); 

System. out. println("questa istruzione non viene 

mai eseguita"); } 

private static void a() { 

b(); 

System. out. println("questa istruzione non viene 

mai eseguita");} 
private static void b() { 
lanciaEccezione(); 

System. out. println("questa istruzione non viene 

mai eseguita");} 
private static void lanciaEccezione() { 

throw new SimpaticaEccezione("eccomi qua!"); 
//System. out. println("questa istruzione non viene 
mai eseguita"); // non compila! } 
} 
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Se fai girare questo programma, otterrai: 

it.ioprogrammo. co rsojava. eccezioni 1. Simpatica Eccezione: 

eccomi qua! 
at ìt.ioprogrammo.corsojava. eccezioni 1. Staffetta. 

lanciaEccezione(Staffetta.java:18) 
at Ìt.ioprogrammo.corsojava. eccezioni 1. Staffetta. b( 

Staffetta .java: 14) 

at Ìt.ioprogrammo.corsojava. eccezioni 1. Staffetta. a( 

Staffetta.java:10) 

at Ìt.ioprogrammo.corsojava. eccezioni 1. Staffetta. main( 

Staffetta .java: 6) 
Exception in thread "main" 

Il mainO ha chiamato il metodo aQ. Quando il siste- 
ma entra in aQ, da qualche parte deve esserci scritto 
chi lo ha chiamato - altrimenti, all'uscita da aQ, il 
codice non saprebbe dove tornare. Lo stesso avviene 
quando aQ chiama bQ: il sistema deve ricordare che 
bO è stato chiamato da aQ, e che aQ è stato chiama- 
to da mainQ. Quindi, in ogni momento, mentre il 
programma gira, esiste una struttura che "ricorda" 
l'ordine di tutte le chiamate, dalla JVM che chiama il 
mainO fino al metodo attualmente in esecuzione. 
Questa struttura si chiama stock delle chiamate a 
metodo. Il metodo bQ chiama lanciaEccezioneQ, che 
crea e lancia una SimpaticaEccezione. A questo pun- 
to è come se il sistema incontrasse una forma ano- 
mala di return: il metodo termina immediatamente, 
e il controllo torna al metodo chiamante bQ. Ma an- 
che bO, non sapendo cosa fare dell'eccezione, termi- 
na immediatamente e passa l'eccezione al proprio 
chiamante a(). Come una staffetta, l'eccezione passa 
di mano in mano, facendo il percorso inverso delle 
chiamate a metodo, fin quando non torna al main() 
e infine alla JVM. Questo segna la fine del program- 
ma. Nessuna delle System.out.printlnO viene esegui- 
ta, perché l'eccezione interrompe il flusso del pro- 
gramma e costringe Java a "riawolgere il nastro". Ho 
dovuto persino commentare la stampa nel metodo 
lanciaEccezioneQ perché il compilatore, accorgen- 
dosi che quel codice è in ogni caso irraggiungibile, 
avrebbe altrimenti rifiutato programma. 



AFFERRALE AL VOLO 

Abbiamo detto che le eccezioni si propagano all'in- 
dietro attraverso lo stack delle chiamate ai metodi, 
fin quando non raggiungono la radice del program- 
ma. Ma perché questo lungo viaggio? Non sarebbe 
meglio se la Virtual Machine fermasse tutto e stam- 
passe l'eccezione sullo schermo? Il motivo è che uno 
dei metodi sulla strada dell'eccezione potrebbe 
sapere come rimediare al problema, o per lo meno 
potrebbe mettere in atto qualche misura di emer- 
genza - forse segnalare il problema all'utente, o scri- 
verlo su un file di log, o riprovare l'operazione con 



parametri diversi. Tutte queste sono strategie per 
gestire l'eccezione. L'idea è che non sempre il codi- 
ce che incontra un'eccezione sa cosa farne; ma forse 
qualche altro metodo, nella catena dei chiamanti, lo 
sa. Per gestire un'eccezione la devi "afferrare", du- 
rante il suo viaggio all'indietro verso il mainO, con le 
parole chiave try e catch (che letteralmente signifi- 
cano prova e afferra). Queste parole si usano sempre 
insieme in un doppio blocco di istruzioni chiamato 
blocco try-catch: 

try { 

codiceChePotrebbeGenerareEccezioni(); 
} catch (ClasseDiEccezioni nomeEccezione) { 

codiceCheGestisceLEccezione() ; } 

Il blocco try prova ad eseguire il codice che potrebbe 
lanciare un'eccezione. Se si verifica un'eccezione del 
tipo specificato, allora il controllo passa al blocco 
catch, che prenderà gli opportuni provvedimenti. 
Ad esempio: 

public class TryCatch { 

public static void main(String[] args) { a();} 
private static void a() { 

try { b(); } 

catch (SimpaticaEccezione e) { 

System. out.println ("Simpatica Eccezione in 

TryCatch. a()"); 

System. out.println("Messaggio:" + e.getMessage()); } 
System. out.println("Questa riga viene eseguita");} 
private static void b() { lanciaEccezione(); } 
private static void lanciaEccezioneQ { 

throw new SimpaticaEccezione("eccomi qua!"); 

_J 

} 

Il mainO chiama aQ, che chiama b(), che chiama 
lanciaEccezioneQ, che lancia una SimpaticaEccezio- 
ne. Ma nel suo viaggio all'indietro verso il mainQ, 
l'eccezione si ritrova all'interno di un blocco try- 
catch. Il controllo passa subito al blocco catch, che 
dichiara di voler afferrare tutte le eccezioni di classe 
SimpaticaEccezione. Qui l'eccezione riceve un nome 
(come se fosse un parametro) e viene usata per le 
eventuali contromisure. L'esempio si limita a stam- 
pare qualche messaggio sullo schermo (il metodo 
Exception.getMessageO restituisce messaggio asso- 
ciato all'eccezione): 

SimpaticaEccezione in TryCatch.aO 
Messaggio: eccomi qua! 
Questa riga viene eseguita 

Per questo mese ci fermiamo qui. Il mese venturo fa- 
remo altri esempi, e parleremo delle importanti ec- 
cezioni checked. A presto! 

Paolo Perrotta 




RIVOLGERSI 
ALLA FAMIGLIA 

Puoi usare super, 
seguita dall'invocazio- 
ne di un metodo, 
anche per chiamare un 
metodo della super- 
classe che non è un 
costruttore: 



super.metodo() 

Questa forma è utile 
quando devi chiamare 
la versione originale di 
un metodo dalla sua 
versione "overridden": 

class Superclasse { 
public void f() { 
System. out.println( 

"Superclasse. f()"); 
faiQualcosaDiImportante(); 
} 

} 

class Sottoclasse extends 
Superclasse { 
public void f() { 
System. out.println( 

"Sottoclasse. f()"); 
super.f(); // chiama 

Superclasse. f() 

faiAltreCoseQ; } 

} 

Sottodasse.fQ aggiun- 
ge funzionalità a 
Superdasse.fO senza 
eliminare le funziona- 
lità originali e senza 
duplicare il codice. 
Quando usi super in 
questo modo, non sei 
nemmeno obbligato 
ad usarlo come prima 
istruzione del metodo. 
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Applicare lo stile di Windows XP all'interfaccia di un'applicazione 

Interfacce in stile XP 

Dopo una breve panoramica su Windows XP Visual Style 
implementeremo un'applicazione che interagisce con un database 
Access. Un look nuovo per i nostri programmi 
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Conoscenze richieste 
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Elementi di Visual Basic 



Piattaforma Windows 
XP -Visual Basic 6 SP6. 






Le Visual Styles sono le specifiche relative all'a- 
spetto degli elementi dell'interfaccia utente. 
Esse definiscono i colori, i font, le dimensioni 
dei controlli ecc. e forniscono i meccanismi per im- 
postare le interfacce delle applicazioni Windows-ba- 
sed. Faremo una panoramica sullo stile Windows XP 
e sulle problematiche connesse alla sua applicazio- 
ne nei progetti Visual Basic e descriveremo un'appli- 
cazione (naturalmente in stile Windows XP) che am- 
ministra i dati dei clienti e dei relativi ordini. L'appli- 
cazione interagisce con il database ordini.mdb che 
ha due tabelle: Clienti e Ordini. Con Windows XP 
sono fornite la versione 5 e 6 della ComCtl32, alla 
base del nuovo look e feel, la versione 6, rispetto alle 
versioni precedenti, non può essere distribuita 
insieme al progetto Visual Basic, quindi un'applica- 
zione potrà usarla solo se è installata nel sistema 
operativo. Un'applicazione Visual Basic, di default, 
usa gli user control definiti in User32.dll e i common 
control definiti in ComCtl32.dll versione 5; in que- 
sto appuntamento descriveremo come, predispo- 
nendo un file di configurazione (un'application 
Manifest) un'applicazione Visual Basic riesce ad uti- 
lizzare gli user control ed i common control definiti 
in ComCtl32.dll versione 6. Facciamo notare che in 
realtà, eseguendo un'applicazione Visual Basic su 
Windows XP (con tema Windows XP), la ComCtl32 
versione 6 già di default applica lo stile XP alla non- 
client area del form (cioè al frame, alla caption e alla 
non-client serali bars). Con la tecnica che ora de- 
scriveremo, estenderemo lo stile XP anche ai con- 
trolli dell'area client. 



MANIFEST 

PER WINDOWS XP 

I Manifest sono una parte della tecnologia introdot- 
ta da Microsoft per risolvere il problema dei conflit- 
ti tra le versioni della stessa DLL. Un Manifest può 
contenere i metadati che nei precedenti sistemi 
operativi erano inseriti nel registro di sistema, cioè 
informazioni sulle COM Class, sulle interfacce e 
sulle librerie. Un file Manifest può descrivere un Si- 



de-by-Side assembly (una collezione di risorse per 
esempio una DLL) o una isolated application. Nel 
nostro caso il file Manifest, serve per specificare che 
un'applicazione deve agganciarsi alla versione 6 
della ComCtl32.dll (se installata). Di seguito riportia- 
mo il file Manifest che useremo nei nostri esempi: 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<assembly xmlns="urn:schemas-microsoft-com: 

asm. vi" manifestVersion = "1.0"> 
ossemblyldentity 
version = "l. 0.0.0" 
processorArchitectu re = "X86" 

name="nomesocieta.nomeprodotto.nomeapplicazione" 
type="win32" /> 
<description>descrizione applicazione</description> 
<dependency> 
<dependentAssembly> 
Ossemblyldentity 
type="win32" 

name= "Microsoft. Windows. Common-Controls" 
version = "6. 0.0.0" 
processorArchitecture="X86" 

publicKeyToken = "6595b64144ccfldf" 

language="*" /> 
</dependentAssembly> 
</dependency> 
</assembly> 

Il codice precedente va salvato in un file testo, con 
estensione XML, e posto nella directory che contie- 
ne il file EXE dell'applicazione che deve essere tra- 
sformata in stile XP. Ma, attenzione: il nome del file 
Manifest deve essere nel seguente formato: nomevo- 
straapplicazione.exe.manifest. Nelle Tabelle 1 e 2 
sono riassunte le parti principali del file Manifest. 



IDE IH! STILE XP 

Quello che abbiamo detto, in merito al file 
Manifest, lo potete testare impostando, in stile XP 
parte dell'IDE di Visual Basic. Per fare ciò basta 
creare il file ub6.exe. manifest e salvarlo nella direc- 
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tory che contiene il file vb6.exe. Dopo aver fatto 
ciò i controlli intrinseci di Visual Basic, trascinati 
su un form, risulteranno in stile XP. Lo stile XP pe- 
rò, in questo caso, è applicato solo in fase di pro- 
gettazione, non resta traccia nel compilato. 
Vb6.exe.manifest, dunque, è utile solo in fase di 
progettazione mentre, per applicare lo stile XP a 
una vostra applicazione, fate così: 

1. Creare un file Manifest il cui nome rispetti il for- 
mato nomeapplicazione. exe. manifest. 

2. Utilizzare la funzione InitCommonControls, co- 
me prima istruzione della vostra applicazione 
(per comunicare al sistema che si vuole utilizza- 
re la libreria ComCtl32). 



CARICARE 
LA COMCTL32 

Il secondo passo per usare lo stile XE dunque, è l'in- 
serimento delle seguenti istruzioni nel vostro pro- 
getto: 



Private Declare Function I 


litCommonControl 
Lib "Comctl32.dll" 


s 



As 


Long 


Private Sub Form_Initialize() 


Cali InitCommonControls 


End Sub 



Cioè la dichiarazione delle funzione InitCommon- 
Controls e la sua invocazione. Facciamo notare che 
la InitCommonControls deve essere invocata nella 
Initialize altrimenti il form non potrà essere carica- 
to! Allora, se "siete fortunati", per usare lo stile XP ol- 
tre a prevedere il file Manifest sarà necessario ag- 
giungere le istruzioni per caricare la ComCtl32.dll. 
Se invece la fortuna non vi assiste, dovete leggere at- 
tentamente il paragrafo successivo! 



CONTROLLI INTRINSECI 
E STILE XP 

I controlli intrinseci OptionButton e Frame creano 
alcuni problemi, quando sono usati con lo stile XE 
Provate ad inserire in un Frame un OptionButton o 
un altro Frame. In fase di esecuzione vedrete l' Op- 
tionButton di colore nero e il Frame interno con la 
label diversa da quella impostata. Questi problemi 
possono essere risolti inserendo i controlli, interni al 
frame, in un controllo PictureBox. In Fig. 1 mostria- 
mo il problema e il modo in cui è stato risolto (nota- 
te che le PictureBox sono state impostate senza 
bordo e dello stesso colore del frame). Per riprodur- 
re il form di Fig. 1, creare un nuovo progetto (per 
esempio Progettol), predisponete i controlli intrin- 
seci (con e senza PictureBox), impostate il file Mani- 



fest {progetto l.exe.manifest) nella directory del pro- 
getto, compilate e lanciate progettol.exe. Ora possia- 
mo introdurre l'applicazione d'esempio. 



GESTIONE ORDINE 

L'applicazione di esempio (forse con un po' di pre- 
sunzione) è stata chiamata Gestione Ordini. Essa è 




r Attributo 


Descrizione 


Version 


Versione del Manifest. La versione deve essere nel seguente 
formato: n.n.n.n con n<=65535 


ProcessorArchitecture 


Tipo di processore utilizzato, di solito X86 


Name 


Dovrebbe includere il nome della compagnia, il nome del 
prodotto e il nome dell'applicazione (per esempio 
Microsoft. WindowsApplicazioné) . 


Type 


Il tipo di applicazione, di solito Win32 


Tabella 1: Parti principali che compongono il file Manifest 



Attributo 


Descrizione 


Type 


Il tipo di componente da cui dipende l'applicazione, di solito Win32 


Name 


Il nome del componente 


Versione 


Versione del componente 


processorArchitecture 


X86 


publicKeyToken 


Key pubblica usata per firmare il componente, 8 byte cioè 16 
caratteri esadecimali 


Language 


Lingua del componente, di solito "*" per non specificare nessun 
lingua 


i Tabella 2: Altre componenti del file Manifest , 



l'interfaccia per un data- 
base Access (ordini .mdb) 
che include le tabelle 
Clienti (con i campi 
Clientela, Nomesocietà, 
Città, CAP, Paese) e Ordini 
(con i campi Ordineld, 
Clientela, Note, Npezzi, 
Prezzo). La chiave della 
tabella Clienti è il campo 
Clientild, mentre della 

tabella Ordini sono i campi Ordinild e Clientild, in 
base a ciò, ad ogni cliente corrispondono più ordini 
ed un ordine (per semplificare) è composto da una 
sola riga. Sul database, per semplificare ulterior- 
mente, è necessario impostare una relazione (join) 
tra le tabelle che "includi tutti i record di Ordini e 
solo i record di Clienti in cui i campi collegati sono 
uguali". Per quanto riguarda il progetto Visual Basic i 
ncludere le librerie ADO Data Control 6.0 (dato che 
utilizzeremo un controllo ADO data), Windows 
Common Control 5.0 e Windows Common Control-2 
5.0. Sul form, invece, inseriamo un TabStrip con due 
schede: Imposta e Ricerca. La Imposta deve contene- 
re gli elementi che permettono di inserire un nuovo 
Cliente oppure avviare la ricerca dei suoi Ordini; la 
scheda Ricerca, invece, su un ListView, deve mo- 
strare gli ordini trovati nel database (facciamo nota- 
re che manca la scheda per gestire gli ordini e che le 
PictureBox contenitore le abbiamo disposte ma- 




Fig. 1: Gli errori nello stile XP con ì controlli intrinseci 
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Imposta Risultai 



nualmente sulla Tab Strip...)- Ricordiamo che le 
schede del TabStrip non sono oggetti contenitore 
(come nel caso dell'SSTab) per questo ad ogni sche- 
da bisogna associare una PictureBox che raggruppa 
i controlli che deve mostrare. Abbiamo previsto un 
Array di PictureBox, cioè Picturel (0) per la scheda 
Imposta e Picturel (1) per la scheda Ricerca (ecc. se ci 
fossero altre schede). In dettaglio i controlli da pre- 
vedere per la scheda Imposta (cioè sulla Picturel (0)) 
sono: un frame con all'interno gli oggetti (Textbox, 
Label) associati ai campi della 
tabella Clienti e un pulsante 
(all'interno di una PictureBox!) 
per avviare la ricerca degli 
ordini (nominato trova); all'e- 
sterno del frame bisogna pre- 
vedere due pulsanti {nuovo e 
cancella) e un controllo ADO 
data. Sulla Scheda Ricerca, 
invece, bisogna predisporre un 
ListView per presentare i dati 
degli ordini del cliente (specifi- 
cato sulla scheda Imposta). 
Inoltre, all'esterno del TabStrip 
bisogna disporre un controllo 
UpDown per selezionare le 
schede. In conformità a quello che abbiamo descrit- 
to in precedenza e alle librerie che abbiamo incluso 
s'intuisce che il nostro progetto è, quasi, compatibi- 
le con lo stile XP l'unico problema, infatti, è costitui- 
to dall'ADO Data che non 
cambia style in XP. Sappiamo, 
però che con qualche pulsante 
e qualche riga di codice si può 
nascondere o evitare VADO 

Data. Le due schede in stile XP 
Fig. 3: La scheda Ricerca, del TabStrip, in stile XP SQnQ presentate ndle Rg 2 e 3 

Ora possiamo passare alla descrizione del codice. 



Parametri di ricerca 
Codice 


Città 


11 1 Milano 


CAP 




Paese 


1 201 00 




| |ll* 


Meme E 


oc.ti 




^ 


ni Fanali 


ZI 








LZ 


rova | 







Fig. 2: Il forni in stile XP 
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ID 


Prezzo 


M Pezzi 


Note 


1 
3 
5 


1200 
100 

2QQQ 


3 
4 

1 


articoli vari 
cancelleria 



TEMI 
WINDOWS XP 

Un tema (visual style) 
in un sistema operati- 
vo Microsoft determi- 
na lo sfondo, lo screen 
saver, i tipi di caratte- 
re, i colori ecc. In Win- 
dows XP di default so- 
no inclusi due visual 
style: Windows XP e 
Windows Classico (cioè 
lo stile Windows 95). 
Ricordiamo che i temi 
si selezionano dal pan- 
nello di controllo utiliz- 
zando lo strumento 
schermo e che altri te- 
mi sono forniti in Win- 
dows XP Plus Pack. 



INTERAGIRE 

CON IL DATABASE 

Innanzi tutto vediamo il codice necessario per inte- 
ragire con il database. Per caricare VADO Data e i 
textbox della scheda Imposta utilizziamo la seguente: 

Sub CaricaControlloAdoCliente() 
Adodcl.ConnectionString = " Provider= 

Microsoft. Jet. OLEDB. 4.0;" _ 
& "Data Source=" + App.Path + "\ordini.mdb;" _ 
& "Persist Security Info=False" 
Adodcl.RecordSource = "clienti" 
Adodcl.Refresh 

Set Me.txtcodice.DataSource = Adodcl 
Me.txtcodice.DataField = "clienteid" 



End Sub 

Notate che leghiamo i TextBox, con la proprietà Da- 
taSource, all'ADO Data così le azioni fatte sui Text- 
Box si riflettono sul database. Per quanto riguarda gli 
Ordini, relativi ad un dato Cliente, invece, definiamo 
a livello globale il RecordSet RstCliente. 

Public RstCliente As ADODB.Recordset 

che carichiamo attraverso la seguente procedura: 

Public Sub caricacliente(cliente As Integer) 
Dim strenn As String 

strenn = "Provider=microsoft.jet.oledb.4.0;" _ 
& "Data Source=" + App.Path + "\ordini.mdb; " 

Set RstCliente = New ADODB.Recordset 

RstCliente. CursorType = adOpenKeyset 
RstCliente. LockType = adLockOptimistic 
RstCliente. Open "Select * from ordini where _ 
clienteid = " & cliente, strenn, , , adCmdText 

End Sub 

L'argomento cliente, della carìcacliente, è impostato 
sulla scheda Imposta {txtclienteid) . Il codice per 
creare un nuovo Cliente o per cancellarlo lo inseria- 
mo nei pulsanti Nuovo e Cancella: 

Private Sub Nuovo_Click() 

Adodcl. Recordset.AddNew 

Txtcitta.SetFocus 

1 Clienteid è un contatore, il focus 

M'impostiamo su txtcittà 
End Sub 
Private Sub Cancella_Click() 

Adodcl .Recordset. Delete 

Adodcl. Recordset.Requery 
End Sub 



CARICARE IL FORM 

In questo paragrafo inseriamo il codice (da inserire 
nella Form_ Load) che serve per impostare le colon- 
ne del ListView e per caricare i dati del primo Cliente 
(con la CaricaControlloAdoCliente) . 



Me. Txtcittà. Data Field 



"citta" 



Private Sub Form_Load() 


ListViewl.ColumnHeaders. _ 
Add , 


"ID", 


400, IvwCol 


umnLeft 


ListViewl.ColumnHeaders. _ 


Add , 


, "Prezzo", , _ 
IvwColumnCenter 


ListViewl.ColumnHeaders. _ 


Add , 


, "NPezzi", , 




IvwColumnCenter 


ListViewl.ColumnHeaders. _ 


Add , , "Note", ListViewl.Width / 2 


, IvwColumr 


Center 


ListViewl.View = IvwReport 


Picturel(l).Visible =False 
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'imposta la scheda che non si deve vedere 
CaricaControlloAdoCliente 
End Sub 



GESTIONE 
DEL TABSTRIP 

Le schede del TabStrip (realizzate con un array di 
picturebox) possono essere gestite con il seguente 
codice: 



itmX.Si 


bltems(l) = 


RstCliente.Fields 


Item(3) 


itmX.Si 


bltems(2) = 


RstCliente.Fields 


Item(4) 


itmX.Si 


bltems(3) = 


RstCliente.Fields 


Item(2) 


RstCliente.MoveNext 


Wend 


End Sub 




Essa ripulisce il ListView, carica RstCliente con i dati 
degli ordini del cliente (con la caricaclientè) e riem- 
pie il ListView. 



Private Sub TabStripl_Click() 

If TabStripl.Selectedltem. Index <> 1 Then 

Picturel(Q).Visible = False 

If TabStripl.Selectedltem. Index <> 2 Then 

Picturel(l).Visible = False 

Picturel(TabStripl.SelectedItem. Index - l).Visible = True 

End Sub 

Oppure utilizzando un oggetto UpDown nel quale 
inseriamo il seguente codice: 

Private Sub UpDownl_DownClick() 

TabStripl.Tabs(l).Selected = True 

TabStripl_Click 

End Sub 

Private Sub UpDownl_UpClick() 

TabStripl.Tabs(2).Selected = True 

TabStripl_Click 
End Sub 



Imposta | Risultati | 



DISTRIBUIRE 

IL FILE MANIFEST 

In questo paragrafo de- 
scriveremo come include- 
re file Manifest, diretta- 
mente, in un progetto do- 
po averlo trasformato, uti- 
lizzando il tool RC.exe, in 
un file di risorsa (cioè in 
un file .RES). Creiamo un 
file .re e lanciamo il com- 
pilatore RS.EXE con un 
file .BAT. Allora inserire i 
comandi di sotto in un file 
nominato progettol.rc (fi- 
le testo con estensione .re) 
da salvare nella stessa di- 
rectory del file Progettol 
.exe.manifest. 





Codice 


Città 


r 


I Milano 


CAP 


Paese 


120100 
Nome Società 


lltaly 


Windows 95 


trova 







0^ 



nm 



nuovo cancella 



Fig. 4: L'applicazione in stile Windows 95 



RICERCA ORDINI 

In conclusione presentiamo il codice per caricare gli 
ordini del cliente specificato in TxtCodice, cioè la 
procedura TrovajClick: 

Private Sub Trova_Click() 

If txtcodice <> Then 

caricalista (txtcodice) 

TabStripl.Tabs(2).Selected = True 

TabStripl_Click 

End If 

End Sub 

La procedura precedente dopo aver caricato il List- 
View, attraverso la caricalista, seleziona la scheda 
Ricerca. La caricalista è la seguente: 

Public Sub caricalista(codice As Integer) 
Dim itmX As Listltem 
ListViewl.Listltems.Clear 
caricaclientè (codice) 

While Not RstCliente. EOF 

Set itmX = ListViewl.Listltems. 

Add(, , CStr(RstCliente.Fields.Item(0))) 



#define CREATEPROCESS_MANIFEST_RESOURCE_ID 1 

#define RT_MANIFEST 24 

CREATEPROCESS_MANIFEST_RESOURCE_ID 

RT_MANIFEST "Progettol.exe. manifest" 

Con i comandi precedenti si specifica che il file Pro- 
gettol. exe.manifest deve essere classificato come ri- 
sorsa tipo RTJAANIFEST (24) con id CREATEPRO- 
CESS_MANIFEST_RESOURCE_ID (1). 
Poi create file BAT, per esempio lanciaRC.bat, con 
la seguente riga di comando: 

C:\Programmi\Microsoft Visual 

Studio\VB98\Wizards\RC.EXE" /fo 

Progettol. res Progettol.rc 

Anche lanciaRC.bat deve essere salvato nella stessa 
directory del file Progettol.exe.manifest. Facciamo 
notare uno strano errore: file EXE, compilato dopo 
aver incluso file Progettol.res (prodotto con il com- 
pilatore RC.EXE), si avvia soltanto se le dimensioni, in 
byte, del file progettol.exe.manifest sono multipli di 4 
(se progettol.exe.manifest è di 595 byte per renderlo 
multiplo di 4 potete inserire un carattere spazio). 

Massimo Autiero 




InitCommon 
Controls 

La InìtCommonControIs 
viene usata per control- 
lare lo stato di cari- 
camento della libreria 
COMCTL32.DLL. A volte, 
però, se l'applicazione 
include le Windows 
Common Controls di 
Visual Basic, non è 
necessario usare la 
InìtCommonControIs 
(verificatelo con le 
vostre applicazioni!). 
Questo, per esempio, 
succede nel caso 
VB6.exe che usa lo stile 
XP solo grazie al file 
vb6.exe.manifest. 
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XML per progettare le interfacce grafiche 

Interfacce vettoriali 



inXAML 



Chi ha avuto la fortuna di provare Longhorn, avrà sicuramente 
notato un sostanziale cambiamento anche nell'interfaccia grafica 
Non tutti sanno che il tutto è stato realizzato tramite XML... 



Longhorn sarà la futura versione di 
Windows e porterà con sé non poche 
novità, legate, soprattutto, all'intera- 
zione con XML. 

Lo stesso motore grafico (Avalon), che darà 
vita alla nuova interfaccia utente, è stato in- 
teramente progettato per interagire con un 
linguaggio direttamente derivato da XML e 
denominato XAML, acronimo di Microsoft 
Extensible Application Markup Language. 
L'intera grafica di un'applicazione XAML è 
"curata" da un insieme di tag XML che, inte- 
ragendo con codice .NET di alto livello (C#, 
VB.NET, C++.NET,C#), danno vita all'inter- 
faccia grafica. 

Si, è vero, in molti già si chiederanno: ioPro- 
grammo mi spiega una tecnologia che potre- 
mo utilizzare solo nel 2006! Niente paura, 
per venire in contro ai tanti curiosi, c'è stato 
chi ha pensato bene di realizzare un tool che 
consente di utilizzare da subito la nuova tec- 
nologia. 

Lo sviluppatore Paul Colton ha messo a 
disposizione un software xamlon (www.- 
xamlon.com) che consta di due strumenti: 




Fig. 1: Semplice ed efficace l'interfaccia di XamIPad 



Visual Designer for Visual Studio .NET 2003 e 
XamIPad. Il primo mette a disposizione un 
plug-in per Visual Studio .NET 2003, che 
permette di salvare l'interfaccia grafica di 
un'applicazione in linguaggio XAML; il 
secondo implementa, invece, una sorta di 
Notepad per scrivere e testare script XAML; 
in aggiunta consente finanche di convertire 
file SVG e C# in linguaggio XAML nativo 
(Fig.l). 

L'installazione del pacchetto prevede che sul 
proprio sistema operativo sia correttamente 
installata la versione 1.1 del .NET Frame- 
work; quest'ultimo downloadabile diretta- 
mente dal sito Microsoft nell'area download. 



LA SINTASSI XAML 

La sintassi di uno script XAML è molto simi- 
le a quella di SMIL, il linguaggio a marcatori 
di tag, sviluppato come estensione XML, per 
l'integrazione di oggetti multimediali nei siti 
web. 

Tipicamente, uno script XAML si presenta 
come un classico file XML con, in aggiunta, 
tutti i riferimenti per la creazione e gestione 
di una interfaccia grafica in stile Windows: 

<?Mapping XmlNamespace="wf" ClrNamespace= 

"System. Windows. Forms" 
Assembly= "System. Windows. Forms" ?> 
<wf:Form Name="Forml" xmlns= 

"http://schemas.microsoft.com/2003/xaml" 
xmlns:def="Definition" xmlns:wf="wf" Text= 

"La prima applicazione XAML" 
Visible="true"> 

<wf:Button BackColor="Red">Ciao 
mondo! </wf : Button> 
</wf:Form> 




□ CD □ WEB 

\tools\xamlon.zip 



"^ 



-' ' •'-'"• ' 



<n 




REQUISITI 



n.i.i.mm; 



— Basi di XML 



Xamlon, 

.NETFramework1.1, 
VS.NET 2003 (opzionale) 
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AVALOIU 

Avalon è il nuovo 

motore grafico della 

prossima release di 

Windows denominata 

Longhorn; nello 

specifico si tratta di un 

nuovo set di API che 

"aiutano" lo 

sviluppatore nella 

costruzione di 

applicazioni evolute 

dal punto di vista 

multimediale. Con 

Avalon Microsoft 

dovrebbe ridurre il 

numero di API da 70 a 

8 mila facendo leva 

sulle avanzate 

caratteristiche delle 

nuove schede grafiche 

in commercio. 



Per "eseguire" il codice: caricare l'applica- 
zione XamlPad, trascrivere il codice e pre- 
mere il tasto F5 per avviare il motore di ren- 
dering. L'output generato sarà molto fedele a 
quanto proposto in Fig.2 




Fig. 2: La nostra prima applicazione xaml: l'intra- 
montabile Ciao Mondo! 



Un file XAML viene interpretato e compilato 
in fase di runtime; nel particolare, il compi- 
latore XAML genera, per ogni file XAML, una 
specifica classe .NET. Le classi conterranno 
il codice per generare gli oggetti definiti 
nello script XAML. Gli elementi xml, e i rela- 
tivi attributi, sono quindi "mappati" come 
proprietà di codice .NET. Per esempio l'ele- 
mento: 

<wf:Button BackColor="Red">Ciao mondo" 

</wf:Button> 

Sarà mappato in codice C# nel modo 
seguente: 




Notate come le classi siano direttamente in- 
vocate dal nuovo oggetto MSAvalon che, co- 
me già detto in precedenza, rappresenta il 
cuore pulsante della nuova interfaccia grafi- 
ca di Longhorn. 



sia bidimensionali che tridimensionali. 
Chi ha avuto modo di lavorare con SVG, lo 
standard xml per generare grafica 2D, tro- 
verà in XAML molte similitudini, per esem- 
pio la primitiva patii: 

<Path 

xmlns= "http://schemas.microsoft.com/2003/xaml" 
Fill = "LightGreen" Stroke="DarkGreen" 
StrokeThickness="2"> 

< Patri. Data > 

<GeometryCollection> 

<EllipseGeometry Center="65,65" 

RadiusX="55" RadiusY="55"/> 

<EllipseGeometry Center=" 135,65" 

RadiusX="55" RadiusY="55"/> 

<EllipseGeometry Center="65,135" 

RadiusX="55" RadiusY="55"/> 

<EllipseGeometry Center="135,135" 

RadiusX="55" RadiusY="55"/> 

</GeometryCollection> 

</Path.Data> 

</Path> 

Tale primitiva, in SVG utilizzata in modo lie- 
vemente diverso, consente di definire un 
percorso grafico e di associare a questo di- 
versi attributi. Nel codice d'esempio, Path è 
adoperata per creare una "collezione" di 
oggetti geometrici formata da ellissi. Il colo- 
re di riempimento delle ellissi è settato a 
verde chiaro: Fill="LightGreen" mentre il co- 
lore che delinea il contorno delle stesse è 
settato a verde scuro: Stroke="DarkGreen"; 
gli attributi RadiusX, RadiusY e Center, im- 
postano raggio e centro dell'ellisse. 
Il grafico generato dal codice è quello rap- 
presentato in Fig.3 




Fig. 3: Poche righe di codice XAML per generare 
grafica 2D! 



moni solo 20 

XAML essendo nato per progettare interfac- 
ce grafiche, consente di invocare primitive 



XAML include anche elementi di supporto 
per la creazione di grafica 3D. Allo stadio di 
sviluppo attuale, al momento in cui scrivia- 
mo è stata rilasciata la Beta 5, sono definiti il 
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supporto per la gestione dei mesh in moda- 
lità wireframe e solid e la gestione delle luci 
d'ambiente e di quelle direzionali. 
In particolare, sono implementati elementi 
per il posizionamento di una videocamera 
virtuale, per il setting delle luci d'ambiente, 
per la scelta dei materiali, ecc. 
Nell'esempio che segue viene mostrato co- 
me realizzare due cubi rispettivamente di 
colore giallo [<BrushMaterial Brush="yel- 
low"/>) e blu {<BrushMaterial Brush= "blue"l>. 
L'operazione è resa possibile grazie all'ele- 
mento Mesh3D che consente di definire tutti 
i punti che compongono la figura geometri- 
ca tridimensionale, così da rendere possibile 
qualunque tipo di rappresentazione. 

<?xml version="1.0"?> 

<Canvas 

xmlns="http://schemas.microsoft.com/2004/xaml"> 

<ViewPort3D ShadingMode="Flat"> 

<ViewPort3D. Camera > 
<PerspectiveCamera Position="-50,50,100" 

LookAtPoint="0,0,0" Up="0,l,l" 

NearPlaneDistance="0" 

FarPlaneDistance="20" FieldOfView="40"/> 

</ViewPort3D.Camera> 
<ViewPort3D.Models> 
<Model3DCollection> 

<AmbientLight Color="#404040"/> 

<Directionall_ight Color="#C0C0C0" 

Direction = "0.5,-0.25,-l"/> 

<MeshPrimitive3D> 
<MeshPrimitive3D. Material > 

<Brush Material Brush = "yellow"/> 
</MeshPrimitive3D. Materia l> 
<MeshPrimitive3D.Mesh> 





Fig. 4: XAML permette anche la rappresentazione di 
oggetti tridimensionali 



DISEGNARE 
L'INTERFACCIA E 
SALVARLA MI XAML 

La grande forza di XAML consiste nel dare la 
possibilità all'utente di disegnare l'interfac- 
cia grafica di un'applicazione, utilizzando 
una qualunque applicazione di grafica vet- 
toriale; per esempio, possiamo pensare di 
disegnare il tutto adoperando Adobe Illu- 
strator e, successivamente, trasformare il di- 
segno in linguaggio XAML. Procediamo con 
un esempio che traduca in pratica quanto 
appena asserito. 

Con Adobe Illustrator decidiamo di ideare 
un logo. 

Per poter trasformare il file in formato XAML 
è necessario salvare il documento Illustrator 
in formato SVG (menu File->Salva con nome 
e scegliere come formato di salvataggio SVG) 
Dalla maschera selezioniamo il bottone 
Avanzate e dalle Proprietà CSS scegliamo 
l'opzione Presentazione Attributi, deselezio- 
nando tutte le altre opzioni; quindi proce- 
diamo con il salvataggio. 
A procedura ultimata avviamo l'applicazio- 
ne XamlPad e dal menu File selezioniamo la 
voce Import specificando il file SVG poco 
prima salvato. Ecco il codice XAML generato, 
frutto dell'importazione: 

<Canvas def:def="Definition" Width = "265" Height= 

"171.19" xmlns:def="Definition"> 

<Rectangle RectangleLeft="0" RectangleTop = 



SCALARLE 

VECTOR 

GRAPHICS 

SVG acronimo di 
Scalable Vector 
Graphics è un 
linguaggio di grafica 
vettoriale 2D che basa 
le sue fondamenta su 
XML; SVG è stato 
sviluppato e 
approvato dal 
consorzio W3C e la sua 
ultima release è 
targata 1.1. 
Attualmente lo 
standard è stato 
ulteriormente evoluto 
per consentirne 
l'utilizzo anche agli 
sviluppatori del 
mondo mobile. 
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LONGHORN 

Solo di recente 

Microsoft ha dichiarato 

che la prossima 

versione di Windows 

non vedrà luce prima 

del 2006. Alcune delle 

tecnologie che prima 

Microsoft aveva deciso 

di adoperare per 

Longhorn saranno 

posticipate (una su 

tutte WinFS) mentre 

altre, vedi Avalon e 

Indigo, presenti in 

Longhorn, saranno 

anche rilasciate come 

upgrade alla attuali 

versioni di Windows 

XP. 



"11.432" RectangleWidth = "165" 

RectangleHeight="147" Fill="#FF0000" /> 

<Polygon Fill = "#FF0000" Points="265,90.432 

209.349,112.714 196.154,171.19 

157.766,125.148 98.074,130.669 130,79.932 

106.303,24.868 164.423,39.553 

209.469,0 213.463,59.813" /> 

</Canvas> 

Procedendo con il rendering (tasto F5) otter- 
remo il medesimo grafico progettato con 
Adobe Illustrator (Fig.5). Al momento in cui 
scriviamo la versione beta di Xamlon pre- 
senta alcuni bug che si manifestano nell'im- 
port di file nei quali sono mappati font di 
sistema. 




Fig. 5: Logo elaborato con Adobe Illustrator 

LA GESTIONE 
DEGLI EVENTI 

XAML non consente di gestire direttamente 
gli eventi legati agli oggetti istanziati, per 
esempio non è possibile definire una rispo- 
sta all'evento click di un bottone utilizzando 
elementi del linguaggio XAML; per ovviare a 
ciò, XAML si integra con codice .NET ad alto 
livello, tipicamente Visual Basic .NET e/o C#. 
L'esempio che segue mostra come creare un 
pulsante e associare del codice C# che ne 
intepreti l'evento click; anche in questo ca- 
so, così come accade in xml, si fa uso della 
direttiva CDATA per impartire al compilatore 
istruzioni "estranee" allo standard: 

<Canvas ID="root" 

xmlns= "http://schemas.microsoft.com/2003/xaml" 

xmlns:def="Definition"> 

<Button ID="buttonl" Click="Clic_Bottone"> 

Cliccami !</Button> 

<def:Code> 

<! [CDATA void Clic_Bottone( 

object target, ClickEventArgs args) 

{ 

buttonl.content="Ciao Mondo!"; 



} 

]]> 

</def:Code> 
</Canvas> 



IL PLUG-IN 
PER VS 2003 

Come già annunciato in precedenza, il tool 
Xamlon installa un plug-in per VS 2003 che 
consente di utilizzare 1TDE del pacchetto di 
sviluppo per creare interfacce XAML, e 
linkare queste con codice .NET; è così possi- 
bile creare applicazioni .NET la cui interfac- 
cia grafica risieda in un file XAML, modifica- 
bile a proprio piacimento, e la parte esegui- 
bile risieda in un ulteriore file, tipicamente 
.EXE. 

Per provare praticamente il plug-in, basta 
avviare VS .NET 2003 e creare un nuovo pro- 
getto. Dal menu file selezionare le voci Nuo- 
vo->Progetto e dalla cartella Progetti di Vi- 
sual C# optare per la creazione di un nuovo 
progetto XamlonProjects, quindi scegliere 
Xamlon Application. A questo punto l'am- 
biente è operativo. 

Proviamo a creare una semplice applicazio- 
ne che, alla pressione di un generico button, 
cambi la caption dello stesso con la stringa 
"Ciao Mondo!". Da Esplora soluzioni di VS 
.NET 2003 clicchiamo sul Formi. xaml per 
accedere alla finestra principale dell'appli- 
cazione, quindi posizioniamo il button al 
centro della finestra; da notare come FIDE 
incorpori due pulsanti distinti: Design e 
XAML, rispettivamente per "switchare" dalla 
fase di "disegno" RAD dell'applicazione alla 
fase scrittura manuale del codice. 
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Formi 

XAML File 
1KB 



:■•:■■: : Application2 



Fig. 6: 1 due file generati da VS 2003 nella creazione 
di un'applicazione XAML 

A questo punto si procede, così come in ogni 
altra applicazione .NET, associando all'e- 
vento di pressione del pulsante l'azione di 
assegnazione della nuova caption "Ciao 
mondo!": 
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using System; 

using System. Windows. Forms; 

using Xamlon. Windows; 

using Xamlon. Windows. Controls; 

namespace XamlonApplication2 

{ 

public class Formi : _Forml 

_J 

public void Buttonl_Click(Object sender, EventArgs e) 

{ 

Buttonl.Text="Ciao Mondo!"; 

} 

_J 

} 

Si prosegue generando la soluzione. 
In Fig.6 è presente uno screenshot che mo- 
stra i file generati: un file eseguibile: Xam- 
lonApplication2.exe ed un file XAML: formi 
.xaml. Il codice contenuto nel file formi 
.xaml sarà del tipo: 

<?Mapping XmlNamespace="wf" ClrNamespace= 

"System. Windows. Forms" Assembly= 

"System. Windows. Forms"? > 

<?Mapping XmlNamespace="events" ClrNamespace= 

"XamlonApplication2" Assembly= 

"XamlonApplication2"?> 

<wf:Form ID="Forml" Width="328" Top="13" 

Text="Forml" Left="13" IsAccessible="False" 
Height= "200" Capture="False" Bounds="13, 13, 

328, 200" 

TabIndex="0" DialogResult="None" DesktopLocation= 

"13, 13" DesktopBounds="13, 13, 

328, 200" ClientSize="320, 173" AllowTransparency= 

"False" xmlns= "http://schemas.microsoft.com 

/2005/xaml/" xmlns:def="Definition" xmlns:wf="wf" 

def:Class="XamlonApplication2.Forml"> 

<wf:Form.Controls> 

<wf:Button ID = "Buttonl" Width = "256" Top="48" 

Text="Buttonl" TabIndex="0" Size="256, 

56" Location = "32, 48" Left="32" IsAccessible = "False" 
Height="56" ClientSize="256, 56" Capture="False" 

Bounds="32, 48, 256, 56" 

Click="Buttonl_Click" /> 

</wf:Form.Controls> 
</wf:Form> 

Se proviamo a variare qualche parametro del 
file XAML, per esempio aggiungendo l'attri- 
buto BackColor="Red": 



IsAccessible= "False" Height="56" 
ClientSize="256, 56" Capture="False" Bounds="32, 

48, 256, 56" Click="Buttonl_Click" /> 



noteremo che l'applicazione XamlApplìca- 
tion2, senza dover ricompilare il tutto, inter- 
preterà il codice XAML e modificherà la pro- 
pria interfaccia grafica in funzione dello 
stesso. Semplice e geniale. 
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wf:Button ID="Buttonl" BackColor="Red" 

Width = "256" Top="48" Text="Buttonl" TabIndex="0" 
Size="256, 56" Location = "32, 48" Left="32" 



Fig. 7: L'applicazione XamlApplication2 prima e dopo 
l'aggiunta dell'attributo BackColor="Red" al codice 
di forml.xaml 



Inutile sottolineare la potenzialità di questo 
strumento: pensate alla possibilità di varia- 
re, a proprio piacimento, l'interfaccia grafica 
di una qualsiasi applicazione Windows, ma- 
gari utilizzando il programma di grafica vet- 
toriale preferito. 



CONCLUSIONI 

XAML rappresenta solo una delle tante 
nuove tecnologie che dovrebbero far parte 
del nuovo SO di casa Microsoft; certo che 
Microsoft, con XAML, propone una soluzio- 
ne tecnologica che sicuramente cambierà lo 
sviluppo delle applicazioni Windows. 
Grazie a Xamlon, nell'attesa di avere delle 
specifiche complete, e soprattutto in attesa 
della nuova release di Longhorn, possiamo 
adoperarci per far si che le nostre applica- 
zioni siano già in un certo senso Longhorn 
enabled. 
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Estrazione di dati da un file binario con C# 

iPod: estrazione 
dei brani con C# 

L'iPod è forse il lettore audio più diffuso al mondo. È facile inserirvi 
la nostra musica, ma non è così immediato copiare i file dall'iPod 
al nostro PC. Realizziamo una classe C# per estrarre dati e musica 




Li co 

ipod.zip 



WEB 



^ -■>-•• ■ • 



L 



I iPod propriamente detto, di cui è uscita da 
poco la quarta generazione, è un juke box 
di grande capienza (fino a 40Gb), mentre 
l'iPod mini, il bellissimo e piccolissimo lettore colo- 
rato uscito qualche mese fa è un gioiellino da 4Gb le 
cui dimensioni ridottissime e il cui design accatti- 
vante hanno fatto impazzire mezzo mondo (com- 
preso chi scrive). L'iPod legge i principali formati di 
compressione audio, eccezion fatta per WMA. In 
particolare legge MP3, AAC (il codec proprietario di 
Apple, in cui possono essere immesse le informa- 
zioni di protezione dalla copia) e il nuovissimo Ap- 
ple LossLess codec. Oltre ai brani musicali, è possi- 
bile registrare appuntamenti e brani di testo. L'iPod 
può essere connesso al PC tramite USB e FireWire e 
può anche essere visto dal PC come un disco ed es- 
sere quindi utilizzato per scrivere e leggere file. 



Esiste un problema: non è possibile in modo diretto 
"estrarre" e copiare sul proprio hard disk i brani vo- 
luti. Per esempio, non c'è una cartella che contiene 
tutti i brani di un dato CD o di un autore: tali brani 
saranno sparsi per differenti cartelle, insieme a 
brani appartenenti ad album e autori differenti. 
L'ottimo software fornito da Apple per interagire 
con l'iPod, ovvero iTunes, permette di inviare al- 
l' iPod brani musicali nei formati supportati, sia di- 
rettamente che dopo averli convertiti. Non permet- 
te però di estrarre i brani e copiarli sul PC. 
Il nostro scopo sarà semplicemente quello di in- 
dividuare il path di ogni brano presente nell'iPod, 
per poter poi operare l'estrazione, che sarà sempli- 
cemente la copia di un file dal "disco" iPod al disco 
rigido del nostro PC. Scriveremo a tale scopo una 
classe C#. 



jn 




REQUISITI 
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— Basi di 
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programmazione ad 
oggetti, basi di C# 



, .NET framework 1. 1, 
Visual Studio 2003 utile 
ma non obbligatorio. 



m^à^à^à 



UHI GIOIELLINO 
E UHI DATABASE 

A differenza di molti altri lettori mp3 (in particolar 
modo quelli a stato solido) il modello di accesso ai 
brani dell'iPod non è basato su cartelle, ma su un 
database: ovvero all'interno dell'unità c'è un file che 
contiene informazioni come autore, titolo, album, 
genere per ogni brano presente nel dispositivo. I file 
veri e propri risiedono in cartelle, e i percorsi di tali 
cartelle sono memorizzate nel database. Questa 
struttura a database ha un chiaro vantaggio, ovvero 
quello di permettere una navigazione dei brani se- 
condo differenti "viste": 

• per playlist 

• per autore 

• per album 

• per genere 

• per titolo 



ALL'INTERNO DEL DB 

Per capire come estrarre i nostri file mp3, andiamo 
a vedere come è fatto l'albero delle cartelle del disco 
contenuto nell'iPod. 



Conta cts 

Calendars 

Notes 

iPod Agent 

_ +— Library 
iPod_Control 

—Device 

Library 

Music 

— F01 

— F02 

— F03 

— F04 
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Il file che contiene le informazioni volute è iTunes- 
DB, contenuto nella cartella iPod_Control. I nostri 
file musicali sono invece contenuti nelle varie car- 
telle iPod_Control\Music\FXX, con XX che varia. 
Visto che vogliamo estrarre i dati, leggeremo soltan- 
to e non scriveremo sul db. L'inserimento dei file, 
infatti, è procedura ben più complessa e rischiosa: 
se il DB risultasse corrotto, il nostro iPod diverrebbe 
inutilizzabile. Per sicurezza, anche nel nostro caso 
di lettura consiglio di farsi una copia sul PC del file 
di database, e lavorare lì almeno fino a che non 
siamo convinti che il nostro codice sia corretto. Il 
file iTunesDB è un file binario, caratterizzato da una 
sequenza di sezioni delimitate da intestazione di 
quattro caratteri. Ogni intestazione è seguita dalle 
informazioni riguardanti la sezione e a volte le se- 
zioni successive. Se questa è la struttura "fisica" del 
file, la struttura "logica" del database può essere vi- 
sta come un albero: 

MHBD ce n'è solo uno, marca l'inizio del db 

MHSD di tipo 1 inizio delle informazion sui brani 

MHLT 

MHIT inizio di un brano e info sul brano 

MHOD dato stringa per il brano 

MHOD dato stringa per il brano 

continuano i dati fino ali prossimo brano 

MHIT inizio di un brano, ecc 

MHSD di tipo 2 inizio delle informazioni sulle playlist 
MHLP contiene il numero di playlist nel db 

MHYP inizio di una playlist e info sulla stessa 

MHOD di tipo 100 info sulla playlist 

MHOD info sul nome della playlist 

MHIP brano presente sulla playlist 

MHOD di tipo 100 Ordine del brano sulla playlist 

MHIP .„ 

MHOD di tipo 100... 

MHYP 



ni che ci servono per il nostro scopo. L'algoritmo 
che utilizzeremo per l'estrazione è estremamente 
semplice: 

• inizializziamo un oggetto di tipo BinaryReader. 
Andiamo a leggere nel file, per ogni intestazione 
che troviamo andremo a leggere la sezione ade- 
guata, e sposteremo il puntatore del BinaryRea- 
der del numero di byte necessario per arrivare 
all'inizio della prossima sezione. In dettaglio: 

1. estraiamo e saltiamo la sezione di testa, se- 
gnata dal intestazione "mhdb". 

2. estraiamo e saltiamo la sezione MHSD di ti- 
po 1 e la MHLT. Siamo ora nella sezione dei 
brani. 

3. per ogni brano, troviamo una sezione 
MHIT. 

• Creiamo una riga BranoRow nella DataTable 
Brano del nostro DataSet e immettiamo i dati. 

• Estraiamo dalla sezione MHITH numero N delle 
sezioni MHOD presenti 

• Estraiamo per ogni MHOD la stringa corrispon- 
dente e la assegniamo al giusto campo della riga 
BranoRow 

• Quando abbiamo estratto N MHOD, aggiun- 
giamo la riga alla DataTable 

• quando troveremo MHSD di tipo 2 saranno fini- 
ti i brani e cominceranno le playlist. 

• saltiamo MHLP 

• per ogni playlist analizziamo il MHYP e utiliz- 
ziamo MHOD, MHOD e MHIP per estrarre le 
informazioni che ci servono. 

in realtà le informazioni sulle playlist non ci servo- 
no realmente per l'estrazione: sarà però comodo 
averle sotto mano per organizzare la visualizzazio- 
ne dei brani nella nostra applicazione. 




Vedremo quindi come effettuare il parsing di un file 
binario con C# e come utilizzare un DataSet tipiz- 
zato come repository naturale dei dati estratti. 



RIDAMMI I MIEI FILE! 

Per la lettura del file utilizzeremo un oggetto di clas- 
se FileStream e uno di classe BinaryReader, chiara- 
mente dopo esserci assicurati di aver impostato la 
modalità Hard Disk per l'iPod. Questa caratteristi- 
ca, impostabile facilmente in iTunes, ci permette di 
leggere il contenuto dell'iPod in maniera del tutto 
analoga a quanto facciamo con una qualsiasi unità 
disco. In queste pagine, per semplicità e brevità, 
estrarremo da ogni sezione soltanto le informazio- 



UN'ESTRAZIONE 



Il codice dell'estrazione sarà contenuto in una clas- 
se, iTunesDBExtractor. Abbiamo detto inoltre che 
utilizzeremo un DataSet tipizzato. Non solo, lo 
creeremo anche con le relazioni fra le tabelle, in 
modo da poter più agevolmente "navigare" attraver- 
so i dati. Le DataTable di cui avremo bisogno sono 
essenzialmente tre, che realizzano una classica rela- 
zione molti-a-molti: 

1. Brano: conterrà i dati dei brani contenuti 
nell'iPod 

2. Playlist: conterrà dati identificativi delle varie 
playlist, compreso il tipo. Se una Playlist è di tipo 
1, allora è la playlist principale, con tutti i brani. 
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GLOSSARIO 



Intestazione di 

Sezione: ogni sezione 

inizia con quattro byte 

riconoscibili. 

iTunesDB: il file 

contenuto nell'iPod 

ove il lettore 

immagazzina i dati sui 

brani che contiene, allo 

scopo di fornire 

differenti viste 

all'utente. 

MP3, AAC: alcuni dei 

formati di 

compressione audio 

supportati da iPod 

Playlist, una lista di 
brani 

Sezione: il file di DB è 

diviso in sezioni 

contenenti differenti 

informazioni 



Altrimenti è di tipo ed è una playlist ordinaria. 
Relazionebranoplaylist: contiene chiavi 
esterne alle altre due tabelle e permette di as- 
sociare ogni brano a più paylist. 



♦ Brano (Eia, 






<H 
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E pbyfetindex int 
branolndex In: 









Fig. 1: Il DataSet creato in VisualStudio 2003. Il 
DataSet realizza una classe che chiameremo ipocIDS 



All'inizio della nostra classe dobbiamo creare alcu- 
ni membri privati, una proprietà che ci aiuterà ad 
impostare il percorso al file di DB ed i costruttori: 

public class iTunesDBExtractor 
{ //impostazione sezione DataSet 

ipocIDS _DS; 

//la DataRow che conterrà il brano sotto estrazione 

ipodDS.BranoRow _branoCorrenteRow; 

//le DataRow che conterranno i dati della playlist 

sotto estrazione 

ipodDS.PlayListRow _playlistCorrenteRow; 

ipodDS.RelazionePlayListBranoRow 

_playlistBranoCorrenteRow; 

//gli oggetti che serviranno alla lettura 

BinaryReader _bReader; 

FileStream _fileStr; 

//privato per la prperty 

strìng _percorsoDB=""; 

//flags di stato 

bool _sezioneBrani = false; 

bool JnLetturaPlaylist = false; 

int _playlistlndex = 0; 

//numero di stringhe contenute nel brano corrente 

int _numerodistringhe=0; 

/// <summary> 

/// proprietà che imposta il path al file ITunesDB 

/// </summary> 

public string PercorsoDB 

{ set 

{ _percorsoDB=value; } 
get 
{ return _percorsoDB; } 

} 

/// <summary> 

/// costruttore di default 
/// </summary> 
public iTunesDBExtractor() 
{} 



/// <summary> 

/// costruttore che permette l'impostazione del path 

/// </summary> 

/// <param name="PercorsoDB"x/param> 

public iTunesDBExtractor( string PercorsoDB) 

{ _percorsoDB= PercorsoDB; } 

Avremo ora bisogno di tre funzioni helper. Le prime 
due ci aiuteranno ad estrarre stringhe ASCII e 
Unicode dai byte letti dal nostro BinaryReader, l'al- 
tra ci servirà a saltare sezioni di cui non ci interessa 
il contenuto. Il funzionamento di quest'ultima è 
semplice se si considera che generalmente i primi 
quattro byte di una sezione sono l'intestazione 
(mhdb, mhod ecc) mentre i secondi quattro indica- 
no la lunghezza della sezione: 

/// <summary> 

/// converte un buffer di byte in una stringa ASCII 

/// </summary> 

/// <param name="buffer"x/param> 

/// <returnsx/returns> 

private string LeggiStringaA(byte[] buffer) 

{ return System.Text.Encoding. ASCII. GetString(buffer); 

} 

/// <summary> 

/// converte un buffer di byte in una stringa Unicode 

/// </summary> 

/// <param name="buffer"x/param> 

/// <returnsx/returns> 

private string LeggiStringaU(byte[] buffer) 

{ return System.Text.Encoding. Unicode. GetString(buffer);} 

/// <summary> 

/// passa alla prossima sezione per le sezioni di cui non 

/// interessa il contenuto 

/// </summary> 

private void SaltaSezione() 

{ //i primi quattro bytes ci dicono la lunghezza del record 

int Lunghezza = _bReader.ReadInt32(); 

//arriviamo alla fine dell'intestazione 

//che si trova a Lunghezza -8 (intestazione+campo 

lunghezza) byte 
_bReader.ReadBytes(Lunghezza - 8); 
} 

Siamo arrivati al cuore della classe, ovvero al me- 
todo che estrarrà i dati dal DB e che popolerà il 
DataSet: 



/// <summary> 


/// metodo publico principale 


che estrae il dataset con 
le informazioni volute 


/// </summary> 


/// <returnsx/returns> 


public ipodDS ExtractDS() 


{ try 


{ if (PercorsoDB= = "") throw new 
"percorso al DB 


Exception( 

non inizializzato"); 
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//creo un file stream 

_fileStr = new FileStream(_percorsoDB, 

FileMode.Open); 
//apro il BinaryReader su questo filestream 
_bReader = new BinaryReader(_fileStr); 

//imposto il Dataset. 

//per evitare problemi e migliorare le prestazioni 
//imposto a false il controllo dei constraints 

_DS= new ipodDSQ; 

_DS.EnforceConstraints=false; 
//leggo la prima intestazione 
string intestazione = LeggiStringaA( 

_bReader.ReadBytes(4)); 

//entro nel ciclo principale 

while (intestazione. Length>0) 

{ //a seconda dell'intestazione leggo la sezione 

voluta, 
switch (intestazione) 

{ - } 

if (JnLetturaPlaylist) 

{ _DS.PIayList.Rows.Add(_playlistCorrenteRow); 

JnLetturaPlaylist = false; } 
//rimettiamo i constraints nel dataset 
_DS.EnforceConstraints=true; 
return _DS; } 
catch (Exception ex) 
{ throw ex; } 
finally 

{ if (_bReader! = null) _bReader.Close(); 

if (_fileStr! = null) _fileStr.Close();} 



Il funzionamento del metodo è il seguente: una vol- 
ta creati gli oggetti FileStream e BinaryReader che 
realizzeranno la lettura del file, viene creata l'istan- 
za del DataSet che verrà restituita. Dato che l'ordi- 
ne di inserimento delle righe nelle DataTable non 
rispetta le relazioni del DataSet, vengono disabilita- 
ti temporaneamente i controlli di correttezza trami- 
te l'istruzione: 

_DS.EnforceConstraints=false; 

Viene letta la prima intestazione e poi si dà inizio ad 
un classico ciclo while in cui è presente un'istruzio- 
ne di selezione che esegue differenti operazioni a 
seconda dell'intestazione letta e dello stato della let- 
tura. Le funzioni chiamate estraggono i dati dalle 
varie sezioni e verranno illustrate di seguito. In par- 
ticolare vediamo che per alcune sezioni viene invo- 
cata la funzione SaltaSezione che permette di pas- 
sare velocemente alla prossima sezione senza 
estrarre dati dalla sezione interessata. Chi volesse 
invece estrarre tali informazioni può consultare i va- 
ri documenti riportati nei box laterali ed operare l'e- 
strazione con le tecniche utilizzate in questo artico- 
lo. Alla fine del ciclo while viene letta la prossima 
intestazione e così via fino alla fine. Una volta usciti 



dal ciclo, viene aggiunta l'ultima riga alla tabella 
PlayList e vengono ripristinati i controlli sul Data- 
Set che viene restituito al chiamante dopo la chiu- 
sura degli oggetti di lettura. Ma andiamo a vedere le 
funzioni chiamate per effettuare l'estrazione vera e 
propria. 

/// <summary> 

/// estrazione dei dati della sezione Mhit, per un brano 

/// </summary> 

private void EstraiSezioneMhitQ 

{ //alcune informazioni vengono messe nella riga 
//altre vengono estratte per usi futuri 
int LunghezzaSezione = _bReader.ReadInt32(); 
int LunghezzaSezioneEFigli = _bReader.ReadInt32(); 



} 



La funzione EstraiSezioneMhit viene chiamata dal 
ciclo principale dopo aver incontrato un'intesta- 
zione "mhit" e dopo aver creato un oggetto di tipo 
ipodDS.BranoRow. Tale oggetto, JbranoCorrente- 
Row, verrà utilizzato per inserire i dati del brano 
corrente e poi verrà aggiunto alla DataTable_DS 
.Brano. Nel codice della funzione infatti si vede co- 
me alcuni dei valori letti vengono inseriti nella riga, 
ad esempio: 

_branoCorrenteRow.Anno =_bReader.ReadInt32(); 
_branoCorrenteRow.BitRate = _bReader.ReadInt32(); 
_branoCorrenteRow.SampleRate = _bReader.ReadInt32(); 
_branoCorrenteRow. Volume = _bReader.ReadInt32(); 

mentre altri vengono semplicemente estratti e mes- 
si in variabili non utilizzate. Questo perché, in futu- 
ro si potrebbe voler utilizzare questi valori. Altri byte 
vengono estratti tramite il metodo ReadBytes del 
BinaryReader e non vengono memorizzati: in tal 
caso i byte non contengono informazioni significa- 
tive o conosciute. Questa strategia viene mantenuta 
anche nelle altre funzioni di estrazione. Dalla lettu- 
ra fatta si conosce il numero di stringhe che conten- 
gono informazioni per un dato brano: utilizzeremo 
questa informazione al momento di estrarre le 
stringhe per decidere quando sia giunto il momento 
di aggiungere la riga alla tabella e passare al prossi- 
mo brano. 

/// <summary> 

/// estra i dati da una sezione stringa 

/// </summary> 

private void EstraiSezioneMhod() 

{ int lunghezzaSezione=_bReader.ReadInt32(); 

int lunghezzaSezionelOO = _bReader.ReadInt32(); 
■■■} 

La sezione stringa (mhod) contiene una stringa 
Unicode che assume differente significato a secon- 




I FILE NEL CD 

lTUNESEXTRACTOR.CS : la 

classe che effettua 
l'estrazione dei dati 



ipodDS.xsd, ipodDS.cs: i 
file del DataSet 
tipizzato 

tali file devono essere 
aggiunti alla eventuale 
applicazione. Si noti 
che il namespace delle 
classi è TestAppIp. Per 
importare il dataset 
potrebbe essere 
necessario creare un 
nuovo dataset e 
copiare in questo le 
tabelle del dataset 
ipodDS.xsd. 
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SUL WEB 



www.apple.it/ipod 

per la struttura del file 

iTuneDB, ci sono 

numerose fonti, fra cui 

quelle del progetto 

http://sourceforqe,net/pro 

ìects/ipod-on-linux/ 

Spiegazione header 

http://sourceforqe.net/ 

docman/display doc.php? 

docid=11191&qroup id= 

52976 

Introduzione agli 
header 

http://sourceforge.net/ 

docman/display doc.php? 

docid=11212&qroup id= 

52976 
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da del suo tipo. Nel codice si vede come questo sia 
stato sfruttato per decidere a quale campo dell'og- 
getto JjranoCorrenteRow o _playlistCorrenteRow 
assegnare la stringa estratta. Per quanto riguarda 
invece le playlist, utilizziamo le funzioni seguenti: 

/// <summary> 

/// Legge la sezione Mhyp per ogni Playlist 

/// </summary> 

private void EstraiSezioneMhyp() 

{ if (MnLetturaPlaylist) 

{ _playlistCorrenteRow = 
_DS.PIayList.NewPlayListRow(); 

} 

int lunghezzaSezione = _bReader.ReadInt32(); 
int lunghezzatotale = _bReader.ReadInt32(); 
int indice = _bReader.ReadInt32(); //non univoco?? 
//se di tipo 1 è la playlist principale 
_playlistCorrenteRow.quantibrani = 

_bReader.Read!nt32(); 

_playlistCorrenteRow.tipo = _bReader.ReadInt32(); 

_bReader.ReadBytes(12); 

_playlistlndex+ + ; 

_playlistCorrenteRow. index = _playlistlndex; 

_bReader.ReadBytes(lunghezzaSezione - 36); } 

/// <summary> 

/// un brano nella playlist 
/// </summary> 
private void EstraiSezioneMhip() 
{ _playlistBranoCorrenteRow = 

_DS.RelazionePlayListBrano. 
NewRelazionePlayListBranoRowQ; 
_playlistBranoCorrenteRow.playlistindex = 

_playlistCorrenteRow. index; 
int lunghezzaSezione = _bReader.ReadInt32(); 

int altro = _bReader.Read!nt32(); 

_bReader.ReadBytes(8); 

int correlazione = _bReader.ReadInt32(); 
_playlistBranoCorrenteRow.branoindex = 

_bReader.Read!nt32(); 

int sconosciuto = _bReader.ReadInt32(); 
_DS.RelazionePlayListBrano.Rows.Add( 

_playlistBranoCorrenteRow); 
_bReader.ReadBytes(lunghezzaSezione - 28); 
} 

Queste funzioni, rispettivamente, estraggono i dati di 
una playlist e di un brano che le appartiene. Una volta 
estratti i dati e popolato il DataSet potremo utilizzare 
i dati contenuti nel campo Path delle righe della 
tabella Brano per estrarre dal nostro iPod i brani, sem- 
plicemente effettuando una normale copia fra file, 
per esempio data una riga RigaBranoRow che contie- 
ne i dati di un brano, e avendo in iPodDrìve il nome 
dell'unità disco assegnata all'iPod, il seguente codice 
copia il brano sul disco C: 

string PathOriginale= iPodDrive+": 



\\"+RigaBranoRow.Path; 

string Estensione= RigaBranoRow. Path. Substrìng( 

RigaBranoRow. Path. Length-3, 3); 
File.Copy(PathOriginale, @"c:\" + RigaBranoRow. Titolo+ 

"." +Estensione); 



CONCLUSIONI 

È interessante notare che l'aver utilizzato un 
DataSet per i nostri dati ci permette di scrivere 
un'interfaccia sofisticata per l'applicazione che uti- 
lizza la nostra classe, mostrando i brani sotto le viste 
cui siamo abituati in iTunes o nell'iPod stesso. Per 
esempio, se nella nostra applicazione volessimo 
popolare una combobox con le playlist trovate 
potremmo scrivere un codice del genere: 

iTunesDBExtractor itb= new iTunesDBExtractor(); 
itb.PercorsoDB=@" O:\iPod_Control\iTunes\itunesDb"; 

I/o il nostro path!!! 

ipodDS _ds= _ds=itb.ExtractDS(); 

comboBoxl. Data Source=_ds.PlayList.Select("", "tipo 

desc"); 

comboBoxl. Display Member= "nome"; 

mentre per popolare una datagrid a partire dalla 
playlist selezionata, potemmo scrivere nel gestore 
d'evento appropriato: 

ipodDS. PlayListRow P=_ds.PlayList.Select( 

"nome="'+comboBoxl.Text.Replace('"",""")+'"")[0] 
as ipodDS. PlayListRow; 
ipodDS. RelazionePlayListBranoRow[] Relazioni = 

P.GetRelazionePlayListBranoRows(); 

ListViewItem LVI; 

ListViewItem[] Items= new ListViewItem[ 

Relazioni. GetLength(O)]; 

int idx=0; 

foreach (ipodDS. RelazionePlayListBranoRow Riga in 

Relazioni) 
{ LVI=new LìstViewItem(); 

LVI.Subltems.Add(Riga.BranoRow.Titolo); 

LVI. SubItems.Add(Riga.BranoRow. Path); 

LVI.SubItems.Add(Riga.BranoRow.IsArtistaNull() 

?"": Riga. BranoRow. Artista); 
LVI.SubItems.Add(Riga.BranoRow.IsAlbumNull()? 

"": Riga. BranoRow. Album); 

rtems[idx++] = LVI; } 

listViewl.Items.Clear(); 
listViewl.Items.AddRange(Items); 

A questo punto è facile utilizzare le tecniche 
standard di filtro dei dati per far sì l'interfaccia 
dell'applicazione sia completa e accattivante 
quanto vogliamo. Buon divertimento a tutti gli 
iPod-maniaci! 

Marco Poponi 
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Realizzazione degli "oggetti" di Sierpinski in 2P e 3D 

Costruzioni 
geometriche iterative 

Le figure di Sierpinski rappresentano un'interessante forma d'arte e sono 

alla base delle teoria per la costruzione dei frattali. 

Un esempio di geometria che trova la sua massima espressione con i PC 



"O 



rdiniamo il caos". Dietro tale ossimoro 
non si cela un banale controsenso, ma il 
tentativo di chiarire una materia ricca 
di teoria e applicazioni. Ci prefiggiamo di studiare e 
analizzare un ben circoscritto ambito del caos. 
Abbiamo più volte affrontato l'argomento, in questo 
spazio della rivista, con particolare attenzione 
all'applicazione più allettante: i frattali. Nel presente 
appuntamento non parleremo di frattali, anche se in 
fondo ne svilupperemo uno, ma concentreremo le 
nostre attenzioni verso aspetti geometrici. Costrui- 
remo graficamente nuovi oggetti con opportuni al- 
goritmi. In particolare, ci dedicheremo allo studio 
delle forme di Sierpinski, con l'obiettivo finale di 
costruirne di interessanti nello spazio 3D. Un esem- 
pio suggestivo è riportato in Fig. 1. 




Fig. 1: Una suggestiva rappresentazione del cubo di 
Sierpinski 

Ribadisco ancora una volta come la soluzione di 
problemi di questo tipo non sia soltanto un esercizio 
per sollecitare la personale corda estetica, ossia una 
pura attività artistica, ma si tratti spesso dello zoc- 
colo teorico per lo sviluppo di una più ampia casisti- 
ca di problemi. Quindi, se è vero che gli output che 
ci apprestiamo a produrre, le forme di Sierpinski, 
sono vere e proprie forme d'arte, peraltro presenti in 
regolari mostre sia tradizionali che su web; è altret- 
tanto una realtà che sono stati un utile strumento 



per lo studio di fondamentali concetti della mate- 
matica moderna, come l'auto similarità e la dimen- 
sione frazionaria. Tenterò, nei prossimi paragrafi, di 
fornire tutte le nozioni necessarie per raggiungere lo 
scopo prefissato, ovvero, la produzione di forme 3D. 
Durante il percorso ne approfitteremo per esplorare 
importanti nozioni teoriche . 



IL PRIMO TENTATIVO 

Una significativa base teorica all'argomento è forni- 
ta dal contributo del famoso matematico Cantor. 
Egli, con un semplice quanto esplicativo procedi- 
mento, costruì un insieme di infiniti elementi. Per 
generare l'insieme di Cantor si deve considerare un 
segmento di lunghezza 1, i cui estremi 
sono i numeri e 1 (compresi). Tale seg- 
mento viene diviso in tre parti; la parte 
centrale rimossa. Ai due segmenti rima- 
nenti si applica la stessa tecnica, cosic- 
ché, iterando si ottiene man mano un 
maggior numero di segmenti di lunghez- 
za sempre minore, come mostrato in Fig. 
2. Alla generica iterazione i, il numero di segmenti è 
2i, mentre la lunghezza di ognuno di essi è pari a 
l/3i. ^insieme dei terzi centrali di Cantor o maggior- 
mente conosciuto come l'insieme di Cantor è quin- 
di prodotto dai segmenti che si hanno dopo infinite 
iterazioni. La continua foratura dei segmenti contra- 
riamente a ciò che saremmo indotti a pensare, non 
produce un insieme vuoto, bensì infiniti punti. La 
dimostrazione, per la sua logica discreta, ha affinità 
con la programmazione. Poiché ad ogni passo, per 
un generico segmento ne vengono prodotti due 
nuovi, allora ogni estremo può essere individuato da 
un percorso, ossia una sequenza di riferimenti a de- 
stra (D) o a sinistra (S). Semplificando, una sequen- 
za di S e D. Ad esempio, 1 viene individuato da una 
successione di tutte D, poiché indica sempre il seg- 
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Fig. 2: Insieme di Cantor 
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SOFTWARE 

Nel CD, oltre al 

programma presente 

sull'articolo, sono 

raccolti dei programmi 

sviluppati per altri 

articoli correlati. 




Fig. 3: Assioma e generatore per 
l'insieme di Cantor 



mento di destra. Il numero 1/3 (si veda la Fig. 2) è 
dato dalla sequenza SDDDD. . . è cioè sempre l'estre- 
mo destro a partire dal primo segmento sinistro. La 
dimostrazione di Cantor si basa sull'esame della 
sequenza oscillatoria SDSDSDSD... che non è un 
estremo, poiché non termina in una successione co- 
stante di tutte D o di tutte S (proprietà di un estremo 
di intervallo), mentre è un punto dell'insieme pro- 
prio, perché corrisponde ad una successione di D e 
S. Il punto vale 1/4 poiché è una serie matematica il 
cui risultato è noto. È adesso chiaro come si genera 
l'insieme di Cantor. Di seguito è proposto un meto- 
do formale che sarà utile nei prossimi paragrafi. 
Ogni elemento dell'insieme (nel caso specifico un 
generico segmento) detto assioma, viene sostituito 
da un generatore. Iterando il procedimento di sosti- 
tuzione di assiomi con generatori si perviene all'in- 
sieme descritto. L'assioma è il segmento pieno, men- 
tre il generatore (il cosiddetto segmento forato) è 
costituito da due segmenti e uno spazio centrale; 
tutti elementi di lunghezza pari ad un terzo dell'as- 
sioma (Fig. 3). Ovviamente, la coppia 
assioma-generatore si intende in scala e 
non di lunghezza fissa, per cui alla pri- 
ma iterazione assioma avrà lunghezza 
1, alla seconda 1/3, alla quarta 1/9 e così 
via. 



PER SAPERNE 
DI PIÙ 



RIFERIMENTI SU 

lOPROGRAMMO 

Nella sezione Soluzioni 

di ioProgrammo, sono 

un utile riferimento gli 

articoli sui frattali ai 

numeri: 50, 51 e 52 

quelli sulla grafica 

reperibili ai numeri: 

36 e 37. 




Fig. 4: Metodo per la 
costruzione di figure 
geometriche iterative 
mediante teoria del caos 



VERSO IL CAOS 

Adesso proviamo a costruire una figura geometrica 
iterativa. Un interessante metodo per crearla in uno 
spazio a due dimensioni fa uso della teoria del caos. 
Si considerano tre punti PI, P2 e P3 di un triangolo 
(se equilatero il procedimento è di più facile intui- 
zione), come mostrato in Fig. 4. Cominciando da un 
punto scelto a caso nel piano, si considera uno dei 
tre vertici, ancora una volta casualmente. Supponia- 
mo che il risultato di tale scelta aleatoria abbia pro- 
dotto il punto PI. Si traccia allora una linea immagi- 
naria tra il vertice Pi e il punto (0), e si riporta il pun- 
to mediano; per intenderci diamo ad esso il nome 1. 
Il processo viene iterato a partire dal punto 1. 
Per chiarezza, descriviamo un altro passaggio. Viene 
scelto casualmente uno dei tre vertici, questa volta 
P2, si traccia il segmento di congiunzione tra i due 
punti e si riporta il punto mediano 2; e così via. 
La funzione rondoni per l'esempio proposto in Fig. 4 
ha generato la sequenza di vertici: 1,3,3,1,2. Nel gra- 
fico realizzato solo per comodità sono stati disegna- 
ti i segmenti di congiunzione dei punti; al fine della 
costruzione grafica tali segmenti sono solo immagi- 
nari. Soltanto i punti verranno realmente tracciati. 
Perché caos? Ci si potrebbe chiedere. Semplicemen- 
te perché si tratta di una costruzione geometrica che 
fa riferimento ad elementi generati casualmente, 
quindi in modo caotico. Ma avremo modo di ap- 



profondire altri aspetti della questione. Soffermia- 
moci un attimo sull'output prodotto da tale procedi- 
mento. È facile intuire come i punti descritti sono 
tutti interni al triangolo. È un po' meno evidente che 
si creeranno delle aree vuote, alcune anche consi- 
stenti in cui non saranno presenti punti. La produ- 
zione grafica in varie fasi del processo di costruzione 
è riportata in Fig. 5. Abbiamo appena sviluppato una 
distribuzione di punti conosciuta come triangolo di 
Sierpinski. 



SIERPINSKI ini 2D 

Un elemento che appare ricorrente, nonché filo 
conduttore, è il concetto di iterazione. Con la conti- 
nua ripetizione dello stesso procedimento si rag- 
giunge l'obiettivo, ovvero la costruzione di particola- 
ri figure geometriche. Come vedremo, una conse- 
guenza sarà la produzione di forme autosimilari. 
Ma, come mostrato in Fig. 5, si può notare come 
processo si completi con numeri di iterazioni sem- 
pre maggiori. Teoricamente bisogna far tendere il 
numero di iterazioni all'infinito. Il programma 
pascal proposto di seguito costruisce il triangolo di 
Sierpinski con centomila iterazioni. Come accortez- 
za, ereditata dalle tecniche per lo sviluppo di fratta- 
li, vengono scartate le prime mille iterazioni; nel lin- 
guaggio proprio dell'ambito dei frattali si parla di 
orbite (e non iterazioni). 

Program Triangolo_dLSierpinski; 
Uses graph; 
var D,G,r : Integer; 
x,y : real; 
i : longint; 
Begin 

D:=Detect; 

Initgraph(D,G, 'c:\tp\bgi'); 

randomize; 

x:=40; y:=50; 

For i: = l to 100000 do 

Begin 

r:=random(3)+l; 
case r of 

1 : Begin 

x:= (400+x)/2; 

y:= (400+y)/2; 

Endj 

2 : Begin 

x:= (200+x)/2; 

y:= (53+y)/2; 

Endj 

3 : Begin 

x:= x/2; 

y:= (400+y)/2; 

Endj 

End; 
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if i>1000 then Putpixel(round(x),round(y),YELLOW); 

End; 

readln; 

Closegraph; 



End. 




Fig. 6: Generazione geometrica del triangolo di 
Sierpinski fasi- triangolo di Sierpinski 

Il punto iniziale è stato fissato a (40,50), si poteva 
anche generarlo casualmente. Mentre i vertici sono 
stati scelti per avere un buon effetto su un tavola gra- 
fica di 640 x 480 punti; essi hanno coordinate rispet- 
tivamente pari a: (200,53), (0,400) e (400,400). La fi- 
gura appena ottenuta con il programma pascal può 
essere generata geometricamente. Si tratta di appli- 
care il processo iterativo di sostituzione assioma- 
generatore, già esaminato per l'insieme di Cantor. In 
Fig. 6 vengono riportati i due elementi: assioma e 
generatore, nonché il risultato ottenuto dopo la 
quarta iterazione. 

Un altro metodo per la generazione del triangolo è 
stato sviluppato da Lindenmayer che ha attuato il 
sistema omonimo. Ad ogni iterazione, gli assiomi 
(qui linee, in tale sistema si focalizza l'attenzione 
sulle linee e non sui triangoli), vengono sostituiti da 
generatori che ad ogni passo vengono opportuna- 
mente scalati. Il sistema è riportato in Fig. 7. 
L'assioma è un solo lato del triangolo. Esaminando 
la figura si comprende chiaramente il processo di 
costruzione. Un lato di un triangolo viene sostituito 
dal generatore opportunamente scalato, i restanti 
due lati vengono riportati così come sono. Ovvia- 
mente, a tale procedimento vanno sottoposti tutti i 
triangoli presenti nella figura in esame. 
Esistono molti sistemi di Lindermayer che possono 
generare gradevoli figure geometriche, come quella 
riportata in Fig. 8, che ricorda il triangolo di Sier- 
pinski pur essendo diversa. La figura ricorda anche 
un merletto che è tanto più rifinito quanto sono 




maggiori le iterazioni. Per chi volesse approfondire 
lo specifico aspetto consiglio di visionare anche il 
fiocco di neve di Van Kock, riferitevi agli articoli cor- 
relati proposti nella rivista. Oltre ai due metodi visio- 
nati per la generazione del triangolo di Sierpinski; il 
primo che fa uso della teoria del caos e che è stato 
implementato da un programma pascal, e il secon- 
do attraverso una costruzione puramente geometri- 
ca che sfrutta la produzione di un generatore appli- 
cato ad un assioma, ne esiste un terzo. Sicuramente 
si potranno individuare anche altri metodi, ma esa- 
miniamo questa semplice idea. Si considera il trian- 
golo si Tartaglia, anche conosciuto come triangolo di 
Pascal (nome ricorrente in questo appuntamento!). 
Per chi non lo ricordasse è usato per stabilire i coef- 
ficienti dei termini della potenza dei binomi. Esso 
assume la forma: 

1 

1 2 1 

13 3 1 

1 4 6 4 1 

1 5 10 10 5 1 





Fig. 8: Sistema di 
Lindenmayer per figura a 
merletto 




SIERPINSKI 

Waclaw Sierpinski nacque il 12, marzo 1882 a Varsavia, quando la città era 
sotto l'occupazione della Russia. I Russi avevano imposto la loro lingua e 
la loro cultura a tutte le scuole secondarie della Polonia e preferivano che 
i polacchi restassero analfabeti, tanto che il numero di studenti era 
crollato. Nonostante le difficoltà, Sierpinski entrò nel dipartimento di 
matematica e fisica dell'Università di Varsavia nel 1899. Nel 1903 vinse 
anche una medaglia d'oro per un suo saggio sulla teoria dei numeri, ma, 
non volendo che fosse pubblicato in russo, attese fino al 1907 quando fu 
edito in inglese. Rischiò di non ottenere la laurea in scienze matematiche 
perché, volontariamente, non superò l'esame di russo; per i suoi meriti 
scientifici tuttavia l'insegnante di russo cambiò in "buono" il pessimo 
risultato del suo esame, ed egli ottenne la laurea. Si occupò di molteplici 
studi: dalla teoria degli insiemi, ai numeri irrazionali, all'astronomia, alla 
filosofia. Anche la 2° guerra mondiale lo segnò e fu costretto alla 
clandestinità. Egli si ingegnò a spedire in Italia le sue carte affinché 
venissero pubblicate, a questo periodo risalgono gli studi sui frattali. 
Dopo la rivolta del 1944 i nazisti incendiarono la sua casa, distruggendo la 
sua biblioteca e tutti i documenti personali. Capace di lavorare in 
qualsiasi condizione, raggiunse infine il meritato successo. Tanti sono i 
riconoscimenti attribuitigli. Mori il 21, ottobre, 1969 a Varsavia. 



Fig. 7: Sistema di generazione dì Lindenmayer 



Per costruire il triangolo di Sierpinski sulla base di 
quello di Pascal bisogna analizzare i singoli elemen- 
ti di questo secondo. Gli elementi dispari faranno 
parte del triangolo, mentre i pari verranno rimossi. 
Si ottiene così un triangolo numerico di Sierpinski 
che, con opportune associazioni numero con por- 
zione di spazio, può dare origine anche a un triango- 
lo in forma geometria dei tipi precedentemente pro- 
dotti. Chiudiamo la rassegna 2D con il quadrato di 
Sierpinski, conosciuto anche come tappeto, che 
come vedremo oltre al solito effetto grafico, ancora 
una volta piacevole, mostra altri motivi di interesse. 
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Fig. 9: Quadrato di Sierpinski 



Per evitare di dilungarci, consideriamo la sola pro- 
duzione geometrica che è riportata in Fig. 9. No- 
tiamo una similitudine tra il quadrato di Sierpinski, 
realizzato in uno spazio 2D, e l'insieme di Cantor 
(Fig. 2). Nel procedimento di Cantor si rimuove alla 
prima iterazione il segmento centrale, nel tappeto di 
Sierpinski il quadrato centrale, e così l'analogia con- 
tinua tra tutti i segmenti del primo procedimento e i 
quadrati del secondo. Come vedremo, anche nello 
spazio 3D si potrà rilevare tale similitudine. 



ALCUNE COSE 
DA SAPERE 

Prima di passare al mo- 
mento clou del nostro 
appuntamento, ovvero 
l'esame di forme 3D, è 
necessario soffermarsi su 
alcuni fondamentali con- 
cetti teorici. Cominciamo 
con l' autosimilarità, ca- 
ratteristica comune a tut- 
te le forme finora costrui- 
te. Si tratta di una pro- 




Fig. IO: Costruzione geometrica della piramide e del 
cubo 



prietà tipica di molte immagini frattali. Si presenta 
quando una porzione di figura è simile ad un'altra 
porzione della stessa figura che la contiene o che è 
contenuta. Più precisamente, definiamo due figure 
come simili se hanno la stessa forma, ovvero, se sono 
uguali a meno di una traslazione e/o un ingrandi- 
mento (o riduzione). Tale risultato si ottiene attraver- 
so una trasformazione lineare. Quando questi carat- 
teri di "somiglianza" sono in un'unica figura, cioè 
una parte di essa è simile ad un'altra parte più gran- 
de (quindi è uguale a questa ultima a meno di un 
ingrandimento e di una traslazione), allora diremo 
che tale figura gode della proprietà di autosimilarità. 
Altro concetto da conoscere per chi ha intenzione di 
approfondire l'argomento è la dimensione di tali 
figure, che non è necessariamente un numero intero 
come siamo abituati a 
pensare. Un modo per ot- 
tenere tale valore da una 
figura geometrica fa uso 
del concetto di autosimi- 
larità appena studiato. 
Un segmento, un quadra- 
to o un cubo sono tutte 
figure autosimilari. Un 
segmento di lunghezza 
unitaria può essere diviso 
in n parti ciascuna di lun- 
ghezza Un, facendo un'a- 
naloga scomposizione 
per il quadrato si otten- 
gono n2 quadratini di 



area lln2 e così n3 cubetti di volume Un3. La dimen- 
sione dei tre oggetti è data dall'esponente di n, ecco 
un metodo semplice e veloce! Sebbene per le figure 
trattate il procedimento sia banale, per i frattali e le 
figure che stiamo studiando non è così. Procediamo 
formalizzando tale tecnica: determiniamo il logarit- 
mo del numero di elementi che servono a comporre 
l'oggetto nei tre casi esposti. 

log(n elementi)^ log(nl)=llog(n) 
log(n elementi)^ log(n2)=2log(n) 
log(n elementi)^ log(n3)=3log(n) 

Poiché le figure estratte restituiscono quella iniziale 
se ingrandite di un fattore n, allora la dimensione è 
rapporto tra i logaritmo del numero di elementi e 
logaritmo di n. Cosicché, per le figure elementari 
segmento, quadrato e cubo le dimensioni D sono: 

D=log(n elementi) /log(n)=log(nl)/log(n)=l log(n)/log(n)=l 
D=log(nelementi)/log(n)=log(n2)/log(n)=2log(n)/log(n)=2 
D=log(nelementi)/log(n)=log(n3)/log(n)=3log(n)/log(n)=3 

Se applichiamo tale procedimento al triangolo e al 
quadrato di Sierpinski si avranno le seguenti dimen- 
sioni: 

Dts = log(n elementi)/log(n)= log(3)/log(2)=1.585 
Dqs = log(n elementi)flog(n) = log(8)/log(3)=1.893 

Ricordo, infatti, che il triangolo viene diviso in tre 
triangolini e che il fattore di ingrandimento per ri- 
pristinare l'immagine dell'iterazione precedente è 2. 
Mentre, il quadrato è diviso in otto quadratini con 
fattore di ingrandimento, per la ricostruzione del- 
l'immagine, 3. 
A sorpresa, i risultati sono numeri razionali. 



OBIETTIVO 
RAGGIUNTO 

Passo conclusivo dell'intero percorso è la produzio- 
ne di oggetti tridimensionali. In questo ambito, le 
abilità artistiche e la fantasia di chi si cimenta nella 
creazione di forme 3D vengono esaltate dando vita 
a sorprendenti realizzazioni. Spesso si possono am- 
mirare tali produzioni in mostre d'arte moderna. 
Ma passiamo all'aspetto tecnico. Il procedimento 
per la costruzione segue le stesse regole del conte- 
sto bidimensionale. La differenza sostanziale nelle 
due circostanze riguarda l'elemento oggetto della 
costruzione; nel caso bidimensionale è un triango- 
lo, mentre in 3D è una piramide. Attuiamo una 
costruzione geometria facendo uso di assioma e 
generatore. In Fig. 10 è riportato, oltre che il risulta- 
to finale, anche la coppia assioma generatore. Nella 
stessa figura, nella sezione b, si può osservare il me- 
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todo applicato alla costruzione del cubo. Un'analisi 
dimensionale, in comparazione con il contesto 
bidimensionale, evidenzia che entrambe gli oggetti 
ottenuti hanno volume zero e un'infinita superficie. 
Il risultato si può anche dimostrare. Come era pre- 
vedibile le analogie nel passaggio dal 2D al 3D non 
si fermano qui. Ad esempio, si può notare come le 
quattro facce della piramide siano dei triangoli di 
Sierpinski, così come le sei facce del cubo corri- 
spondano al tappeto. Nel caso della piramide ogni 
oggetto si scompone in altri cinque, mentre, il fatto- 
re di ingrandimento per rendere un oggetto di egua- 
le grandezza con il suo generatore è due. Questi due 
numeri ci permettono di conoscere anche per la 
piramide la sua dimensione. 

Dp - log(n elementi)/log(n)= log(5)/log(2)=2.322 
De = log(n elementi)Ilog(n) = log(20)/log(3)=2. 727 

Con De indichiamo la dimensione del cubo. Lo svi- 
luppo di un algoritmo che riporti graficamente un 
oggetto tridimensionale come la piramide, può esse- 
re attuato sulla base della teoria del caos, in analogia 
al programma sviluppato per il caso 2D. I vertici di 
cui tener conto sono quattro, cosicché la scelta mul- 
tipla sarà su quattro possibilità; per ognuna di esse si 
dovrà calcolare il punto mediano tra il punto corren- 
te e vertice individuato casualmente. Al termine del 
calcolo non resta che disegnare il punto sullo scher- 
mo. Questa volta non è possibile farlo direttamente 
come nel caso 2D, con la sola chiamata alla funzione 
putpixel (usata in pascal, linguaggio scelto per il 
nostro esempio), sarà necessaria una trasformazione 
da tre a due dimensioni. In altri termini la terna x,y,z 
sarà trasformata nella coppia xl,yl. Per farlo si pos- 
sono adoperare le conosciute matrici di rotazione, 
con le quali stabilire anche i punti di vista dell'osser- 
vatore fissando due coefficienti. Gli oggetti geometri- 
ci iterativi costruiti fino a questo momento non su- 
perano dimensione 3. È comunque possibile andare 
oltre è produrre degli iperoggetti. Un metodo intuiti- 
vo per determinare la geometria 4D di una piramide 
(o meglio iperpiramide) fa riferimento allo stesso og- 
getto in uno spazio ad una dimensione minore. L'og- 
getto in dimensione minore, quindi 3D, sarà definito 
sulla base delle informazioni della dimensione anco- 
ra minore di 1, ossia 2D; e per finire si farà riferimen- 
to allo spazio 1D. Nello spazio bidimensionale un tri- 
angolo viene costruito prendendo un segmento, in 
1D, come base e "tirando" il punto medio in modo da 
portarlo in 2D. Il verbo tirare non è a rigore corretto, 
ma ha il pregio di rendere chiara l'idea, come si potrà 
verificare dalla rappresentazione in Fig. 11. Analoga- 
mente una piramide può essere ottenuta "tirando" 
una figura piana come un rombo (Fig. 11 b). In defi- 
nitiva, la costruzione di un oggetto a dimensione N 
può essere codificata come una serie di compiti ele- 
mentari: 



Partire con un oggetto a dimensione N-l centra- 
to nell'origine; 

Tirare punto medio in modo da generare un 
oggetto di dimensione N; 
Costruire gli spigoli congiungendo il punto me- 
dio a ogni vertice dell'oggetto di dimensione N-l; 
Costruire le facce usando il punto medio e ogni 
spigolo del oggetto di dimensione N-l. 




Usando queste regole, si 
può costruire un iperpi- 
ramide nello spazio 4D a 
partire da una piramide 
in 3D. Alla prima itera- 
zione, la base contiene 
otto iperpiramidi di cui 
una all'apice. Ad ogni ite- 
razione il numero di 
iperpiramidi cresce di un 
fattore 9, cosicché, la di- 
mensione è log(9)l log(2) 
pari a 3.17. Il problema è 
quello di visualizzare l'i- 
peroggetto in uno spazio 
graficamente trattabile 
come 2D o 3D. Le curve 
di livello sono un modo 
per visualizzare un og- 
getto 3D in un piano; in 
2D si riporta il livello del- 
l'oggetto, come se questo 
ultimo fosse intersecato 
da un piano ad una de- 
terminata altezza. Così si 
disegna l'intersezione tra 
il piano e l'oggetto. Una 
pila di Minee di livello da 
una rappresentazione 
dell'oggetto in 3D. Analo- 
gamente, si può proce- 
dere nel passaggio da 3D 
a 4D. In tal caso anziché 
parlare di linee di livello, 
si dovrà trasporre il ter- 
mine in solidi di livello. 
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Fig. 11: Costruzione di oggetti a partire da figure in 
spazi di una dimensione minore 



CONCLUSIONI 

Come abbiamo potuto constatare l'argomento è 
ricco di spunti teorici e prevede diverse possibili 
applicazioni. Inoltre, si possono costruire altre figure 
geometriche, basta avere un po' di fantasia e dime- 
stichezza con il metodo. Infine, un aspetto che meri- 
ta approfondimento è lo studio degli oggetti negli 
iperspazi; è questo uno spunto per un futuro ar- 
ticolo. 

Fabio Grimaldi 
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Giocare con numeri interi e lettere 

Il gioco del 15 

Continua la rassegna di enigmi e giochi che si fondano sulle comuni 
proprietà dei numeri. Il gioco del 15 è semplice quanto sorprendente e 
appartiene ad una più ampia famiglia, il cui capostipite è il quadrato magico 






iJUJtii 




NUMERI INTERI 



L'insieme dei numeri in- 
teri, indicato in mate- 
matica con N, rappre- 
senta gli infiniti elemen- 
ti compresi nell'interval- 
lo aperto ] , infinito 
[, ossia i numeri (senza 
la virgola): 0,1,2... infi- 
nito. In programmazio- 
ne con il termine intero, 
associato a tipi di varia- 
bile, si intende qualcosa 
di leggermente diverso, 
cambia ad esempio il 
range di definizione, che 
per limiti legati alla 
macchina non può es- 
sere infinito. 




9 Nozioni di 
| programmazione 
pascal e di aritmetica 



i 



Nessuno 



wl -^i ^.i 

rasa 



Tempo di realizzazione 



Un foglio di carta o meglio, un blocco note e 
una penna sono gli unici due strumenti che 
serviranno per cimentarsi nello svelare gli 
enigmi di questa puntata. Il protagonista dello spet- 
tacolo è sempre il numero, nella sua semplicità e 
forza. Basterà sfruttare le sue caratteristiche di base 
per accedere alla chiave di tutti i giochi in scena. Il 
nuovo enigma parlerà di zuppe. Fatti i dovuti 
approfondimenti, il sipario si chiuderà su un grande 
rompicapo che conosciamo bene: il quadrato magi- 
co. Quindi, se avete in mano il sacchetto dei pop- 
corn, possiamo cominciare. 



IL GIOCO 
DEL DIVISORE 

Ricordo che il gioco vede due contendenti che, a 
turno devono scrivere su un foglio un numero, se- 
condo prefissate regole. Perde chi non ha alcun nu- 
mero da poter scrivere; il vincitore sarà il suo avver- 
sario. Si parte con un numero generato casualmen- 
te o, alternativamente, proposto da uno dei due par- 
tecipanti, in tal caso, per più partite, sarà un compi- 
to assegnato a turno. Il giocatore a cui spetta la 
mossa, deve individuare per il numero corrente (al 
primo turno l'unico scritto sul foglio) un suo diviso- 
re, e scrivere la differenza tra i due. Il suo avversario 
dovrà fare la stessa cosa, con il nuovo numero appe- 
na riportato. Si continua così fin quando uno dei 
due giocatori perde, allorquando si ritrova un nume- 
ro primo a cui non può sottrarre alcun divisore. Per 
un fissato numero non sono ritenuti divisori validi 
se stesso e uno. Spero che nel corso di questo mese 
gli appassionati del genere abbiano approntato una 
strategia vincente. Essendo il gioco molto semplice, 
individuare una strategia adeguata non risulta 
molto difficoltoso, si tratta di tenere presente alcune 
proprietà dei numeri. L'osservazione principale è 
che un numero dispari può avere soltanto un diviso- 
re dispari. Da ciò si deduce che un numero dispari è 
sempre seguito da uno pari (la sottrazione tra due 
dispari genera sempre un pari). Poiché il gioco non 
può terminare con un numero pari, allora un gioca- 
tore che se lo ritrova non può perdere, almeno in 
quel turno. Quindi, la strategia impone di lasciare al 
nostro avversario, se possibile, un numero primo 
(ma questa sarebbe una situazione alquanto favore- 



vole), oppure, un numero dispari. Questa seconda 
considerazione ci porta ad avere sempre un numero 
pari da trattare al nostro turno, che garantisce l'at- 
tuazione della strategia vittoriosa appena descritta. 
L'analisi approfondita avrà sicuramente deluso 
qualcuno per la cruda realtà emersa, la quale evi- 
denzia che, se entrambi i giocatori conoscono a fon- 
do la strategia, il vincitore sarà il primo giocatore, se 
il numero iniziale è pari, il secondo se dispari. Un 
risultato che dipende fortemente dal caso. Una va- 
riante del gioco che non modifica la sostanza, per- 
mette ai giocatori di considerare uno (1) come divi- 
sore. In questa versione si deve avere la sola accor- 
tezza di lasciare sempre un numero dispari all'av- 
versario. 



IL GIOCO DEL 15 

Ancora un semplice e significativo gioco che si basa 
su numeri interi. I contendenti al solito sono due è 
gli strumenti essenziali sono sempre la carta e la 
penna. Alla strumentazione spartana di un foglio 
puramente bianco del gioco del divisore, per la 
nuova attrazione, si aggiunge una griglia, ossia una 
sorta di vettore di nove caselle numerate da uno a 
nove. A turno, i due sfidanti devono scegliere una 
delle caselle, evitando di occupare quelle già segna- 
te. Come nel gioco del tris, i due giocatori possono 
scegliere uno tra due simboli per marcare le caselle, 
ad esempio, un cerchio e una croce. Il numero se- 
gnato da ognuno dei partecipanti si va a sommare al 
suo personale punteggio che inizialmente sarà 
ovviamente zero. Lo scopo del gioco è quello di tota- 
lizzare 15. Simuliamo una partita per comprendere 
meglio. Supponiamo che due amici: Tizio e Caio, 
decidano di sfidarsi al gioco del 15. Nelle varie parti- 
te che disputeranno dovranno cominciare alternati- 
vamente. Per la prima, supponiamo che tocchi a 
Tizio. Egli segna con la X il primo numero, per 
esempio 6. Caio risponde apponendo un cerchio 
sulla sua scelta, diciamo 9, per evitare che il suo 
avversario vinca al turno successivo. Dopo il primo 
turno il punteggi sono 6 per Tizio e 9 per Caio. Tizio 
al secondo turno sceglie 5. Ricordo che 6 e 9 non 
potevano essere tra le scelte essendo già marcati. 
Caio supponiamo marchi 2. Punteggio: 11 Tizio eli 
Caio. A questo punto Tizio vince segnando 4, infat- 
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ti, realizza 15. Un match può finire in parità, anzi se 
i due giocatori hanno ben capito le strategie vincen- 
ti, è una eventualità che capita spesso. Propongo 
come sfida di questo mese la pianificazione e realiz- 
zazione della giusta strategia per vincere. Come può 
entrare il computer nella questione? Sviluppando 
un programma che sia in grado di giocare contro 
l'uomo; oppure, più facilmente facendo un pro- 
gramma che consenta a due utenti di giocare. È que- 
sto ciò che realizza il semplice programma Pascal 
riportato si seguito. Data la relativa dimensione 
ridotta il listato è riportato integralmente. 

Program verifica; 

USES crt; 

Const Dim = 9; 

Var ctizio, ccaio, turno, x: integer; 



campo,tizio,caio :string[DIM]; 



Begin 

clrscr; 

(* input *) 

write('Nome giocatore 1 : '); readln(tizio); 

write('Nome giocatore 2 : '); readln(caio); 

ctizio:=0; ccaio: = 0; turno:=0; 

campo : = 'LLLLLLLLL'; (* Inizialmente le caselle 

sono tutte libere*) 
while (ctizio<>15) and (ccaio<>15) and (turno<9) do 



Begin 



turno:=turno+l; 



if (turno mod 2) = then (*se pari il turno è 

di tizio altrimenti di caio*) 
Begin 
clrscr; 
writeln('Ciao ', tizio,' il tuo punteggio è 

', ctizio,', tocca a te'); 
writeln(campo); 
repeat 



writeln('Scegli 


il numero (tra 1 e 9)'); 


readln(x); 


until campo[x] = 


'L'; (* Bisogna scegliere 

solo caselle Libere*) 


campo[x]:=T'; 



ctizio: =ctizio+x; 

End 

else 

Begin 

clrscr; 

writeln('Ciao ', caio,' il tuo punteggio è ', ccaio,', 

tocca a te'); 



writeln(campo); 


repeat 


writeln('Scegli 


1 numero (tra 1 e 9)'); 


readln(x); 



until campo[x] = 'L'; (* Bisogna scegliere solo 

caselle Libere*) 
campo[x]:='C; 
ccaio: =ccaio+x 

End; 

End; 

(*Analisi finale degli output*) 

if turno=9 then writeln('Non ci sono vincitori - pareggio') 
else if ctizio=15 then writeln('II vincitore _ ', tizio) 
else writeln('il vincitore _ ',caio) 



end. 



La competizione si svolge sulla stringa campo, che 
inizialmente ha tutte le caselle libere (carattere L); i 
due giocatori, identificati dalle due stringhe tizio e 
caio, devono indicare il numero da segnare. Questo 
processo è codificato all'interno di un ciclo che ter- 
mina con la vittoria di uno dei due o in caso di pa- 
reggio. I due contatori ctizio e ccaio mantengono il 
punteggio. Ogni qual volta i giocatori scelgono una 
casella viene segnata sul vettore campo (con la let- 
tera T, per Tizio, e Cper Caio). Infine, turno indica il 
corrente turno di gioco, esso serve sia per uscire dal 
ciclo in caso di parità e sia per dare alternativamen- 
te avvicendamento ai due contendenti. Per ragioni 
di spazio i controlli sono ridotti al minimo, ad ogni 
modo programma è perfettamente funzionante. 



LA ZUPPA E PRONTA 

Una variante stuzzicante (e come vedremo appeti- 
tosa) del gioco appena visto è la "zuppa di pesce" o 
meglio "soup fish" con il suo nome anglosassone 
originale. Il gioco è simile al precedente, prevede lo 
stesso numero di partecipanti (due che agiscono 
alternativamente) è un campo analogo. La tabella 
riportata di seguito indica il vettore di gioco, che 
questa volta contiene parole. L'attenzione si è quin- 
di spostata dal numero alla lettera. 



VOTE 


KNIT 


ARMY 


CHAT 


FISH 


SOUP 


HORN 


SWAN 


GIRL 



I due contendenti alternativamente devono sceglie- 
re una casella e marcarla, vince chi per primo tota- 
lizza il punteggio 3, ossia chi abbia nel suo set di 
parole tre con la stessa lettera. Esempio: una terna 
vincente è proprio una rivisitazione del titolo del 
gioco: "soup swan fish" per la presenza delle tre S; 
chissà tra l'altro se esiste una zuppa di pesce cigno. 
Ma è vincente anche "army horn girl" per le 3 R. In- 
somma, pur essendoci delle similitudini con pre- 
cedente gioco, la zuppa di pesce (il nome penso che 
sia stato dato per le assurde frasi che si ottengono, 
che ricordano una zuppa) richiede un maggiore 
acume tattico. Ma di questo e altro parleremo alla 
prossima puntata. 



CONCLUSIONI 

Per concludere l'appuntamento di oggi introduco 
un argomento che i fedelissimi di ioProgrammo co- 
noscono: i quadrati magici; insieme ai due giochi 
precedentemente trattati saranno motivo di interes- 
se per il prossimo appuntamento. Si tratta di matri- 
ci quadrate contenenti numeri interi appartenenti 
alla serie 1,2,3 .. n, che hanno una particolare pro- 
prietà, la somma dei numeri, in orizzontale per ogni 
riga, in verticale per ogni colonna e nelle due diago- 
nali dà sempre lo stesso numero. 
Ovviamente tocca a noi incasellare i numeri. 

Fabio Grimaldi 



1 '. • ■ .' '"■ : 

HI Ul 



♦rimi 



GIOCO DEL TRIS 

È un semplice gioco 
che molti conosceran- 
no. Su una matrice 
quadrata, tre righe e 
tre colonne, due gioca- 
tori a turno devono 
segnare una delle 
caselle con il proprio 
simbolo, croce oppure 
cerchio. Vince chi rie- 
sce a fare tris, ovvero 
riporta una sequenza 
dei tre simboli: in oriz- 
zontale, o in verticale 
o anche in diagonale. 
Oltre oceano il gioco è 
conosciuto con il nome 
TicTacToe. 
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Box 



L'esperto risponde... 



Passaggio VB6 a VB Net 

Ho di recente frequentato un 
corso di programmazione VB6 + 
SQL Server 2000 e, parlando con i 
miei docenti che sono dei 
programmatori che sviluppano 
software e tengono lezioni in 
merito, è venuto fuori il discorso del 
passaggio da VB6 al nuovo VB NET. 
Noi che frequentavamo abbiamo 
posto il problema se la 
programmazione in VB6 non fosse 
ormai obsoleta... loro, tra cui un 
docente che tiene seminari anche 
per Micro... (evitando pubblicità :-)) 
ci ha detto di stare ancora tranquilli 
che il passaggio dal vecchio al 
nuovo richiederà ancora un po' di 
tempo, in quanto le case di 
software che hanno sviluppato fino 
ad ora in VB6 non faranno subito il 
grande passo per motivi economici, 
infatti se ci si pensa su convertire 
tutto il programmato al nuovo .NET 
porterà via tempo e quindi per loro 
denaro. 

Sarei molto interessato a sapere il 
vostro parere in merito a quanto da 
me esposto e dal vostro parere e se 
la vivete sul lavoro dalla vostra 
esperienza professionale. 

Risponde Roberto Allegra 

E vero: ci vorrà ancora tempo prima che 
VB6 venga abbandonato del tutto, sia 
per i comodi degli sviluppatori, sia per 
quelli delle aziende. 

Fatto sta che è comunque un linguaggio in 
agonia, a cui è stato anche tolto ogni sup- 
porto ufficiale. E' un po' la situazione in 
cui si trova MFC, a parte il fatto che que- 
st'ultimo è ancora integrato nei nuovi 
Visual Studio. 

VB6 può essere sempre utile per imparare 
qualche principio di programmazione 
senza complicarsi troppo la vita, o per 
spiegare componenti e tecnologie in 
maniera semplice e accessibile a quante 
più persone possibile (questo è il motivo 
per cui scelgo, quando possibile, VB6 
come piattaforma per i progetti trattati nei 
miei articoli). 

Ma alla fine (uno, due anni), soprattutto 
all'uscita del famigerato Longhorn, che 
pare proprio non permetterà più il sup- 



porto a VB6, l'unica alternativa di sviluppo 
sarà .NET, in uno qualsiasi dei linguaggi 
compliant (VB,C#,C++). 
E i programmatori devono pur prepararsi 
per tempo, non credi? Ci vuole tempo per 
assorbire qualla marea di classi fornite 
dalla Class Library, e per "gestire il cam- 
biamento". 

C'è anche da dire che, nel cambio VB6- 
VB.NET/C# non c'è praticamente nulla da 
perdere, e tutto da guadagnare: VB.NET è 
un linguaggio molto più robusto, orienta- 
to realmente agli oggetti, etc... 
Il mio parere è: continua pure a sviluppare 
in VB6 se vuoi fare qualche progettino 
rapido, ma inizia a studiare e collaudare 
progetti inVB.NET e C#. 
Su quale dei due linguaggi orientarsi, 
risponde ad altra questione... 

Crystal da VB.NET 

Sto lavorando ad una WinForm 
con il caricamento di un report. 
Se sul SetDataSouce carico la 
tabella, la mia stampa ha esito 
positivo, invece se caricato da un 
DataSet contente la tabella, 
visualizza il dataviewer vuoto. 



Dim r As New CrystalDecisions. 

CrystaIReports. Engine. ReportDocument 
Dim dasTmp As New DataSet("Tmp") 
dasTmp.Tables.Add(_datLis) 
r = New rptListino 
r.SetDataSource(dastmp) 
CrystaIReportViewerl.ReportSource = r 

Qualcuno mi sa dire perchè? 
Ciao e grazie. 

Paolo 

Risponde Fabio Cozzolino 

Classico problema: non hai letto il mio 
articolo sul numero 79 di ioProgram- 
mo! In poche (pochissime) parole devi 
creare un dataset "tipizzato" ed utilizzarlo 
come sorgente dati del tuo report. Il data- 
set lo crei da Visual Studio .NET aggiun- 
gendo un nuovo file al progetto (nell'elen- 
co troverai anche "dataset"). La spiegazio- 
ne su come farlo è troppo lunga e non può 



essere espressa in poche righe, ti invito, 
perciò, ad effettuare una ricerca su goo- 
gle... Dal codice Vb.Net devi sostituire que- 
sta riga: 

Dim dasTmp As New DataSet("Tmp") 

con questa: 

Dim dasTmp As New NomeMioDataSet() 

C#: Qual è il mio indirizzo? 

Vorrei sapere come si fa ad 
ottenere l'indirizzo IP della 
macchina? 

Andrea Bello 

Risponde Salvatore Meschini 

Con il codice seguente, nella variabile 
Indirizzi avrai un vettore di indirizzi IP: 

PHostEntry ComputerLocale = 

Dns.GetHostByName(Dns.GetHostNameQ); 
IPAddress[] Indirizzi = 

ComputerLocale.AddressList; 

Copiare tabella Access 



C 



buongiorno ho un problema: 
►devo creare una copia di una 
tabella contenuta in un DB Access, 
rinominarla e salvarla all'interno del 
DB stesso. Come posso fare... non 
sono molto esperta, quindi vi prego 
di essere molto clementi nelle 
spiegazioni. Ciao e grazie! 

Paoletta 
Rispond amdbook 

La sintassi SQL per la copia della tabel- 
la dovrebbe essere la seguente: 

SELECT Tabella.* INTO TabellaCopia FROM 

Tabella 

...quindi se vuoi incapsulare il tutto all'in- 
terno di una routine di un CommandBut- 
ton, il codice dovrebbere essere del tipo: 

dim Conn as new Adodb. Connection 
Conn.ConnectionString = "Provider= Microsoft. 
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Jet.OleDb.4.0;Data Source= 
PercorsoFileDatabase.mdb;" 

Conn.Open 

dim SQI as string 

Sql="SELECT Tabella.* INTO TabellaCopia 

FROM Tabella" 

Conn.execute sql 
Conn.Close 

VB.NET: intercettare alt+e 

Salve a tutti: vorrei che nella mia 
applicazione quando da tastiera 
si preme la combinazione alt+e il 
form si chiuda. Come posso fare? 

device78 

Risponde snogar 

Tra le proprietà della Form c'è KeyPre- 
view: mettilo a True e poi inserisci que- 
sto codice: 



Private Sub Forml_KeyDown(ByVal sender 

As Object, ByVal e As 
System. Windows. Forms.KeyEventArgs) 
Handles MyBase.KeyDown 
If e. Alt And (e.KeyCode = Keys.E) Then 

Me.CloseQ 

End If 

End Sub 

MessageBox in Java 
con JBuilder 

Ciao a tutti, qualcuno può 
indicarmi come si può avere 
l'equivalente di una messagebox in 
java con JBuilder? Inoltre, prima di 
posizionare controlli su una JDialog 
devo usare un JPanel ed è ok. Solo 
che questo pannello si posiziona in 
determinati punti della JDialog e 
quindi anche i controlli sono limitati 
nel posizionamento. Non c'è' la 
possibilità di avere a disposizione 
TUTTO il Dialog e non solo "North, 
Sud,..." ? 

Luca 

Risponde Krystal 

Dai un'occhiata alla classe JOptionPa- 
ne. nella stessa documentazione so- 
no riportati alcuni esempi. 
L'unica cosa che devi fare è impostare un 
LayoutManager diverso da quello di 
default {BorderLayout) o, nel tuo caso, set- 
tarlo a nuli... ma ti spiego meglio: 
Nel dover definire la visualizzazione dei 
componenti grafici era necessario delega- 



re a "qualcuno" il compito di gestire, se- 
condo dei precisi criteri, la "disposizione" 
dei componenti. Tale compito è stato asse- 
gnato appunto ai LayoutManager, e in 
Java ce ne sono di diversi tipi: 

• BorderLayout: consente la disposizione 
dei componenti in sei differenti regioni: 
north, south, east, west, e center 



Appi et 



North 



West 



Center 



East 



South 



appi et started. 



• GridLayout: consente la disposizione dei 
componenti in una griglia: 



r 









JJ 



Ce ne sono tanti altri, puoi fare riferimen- 
to alla documentazione ufficiale di Java. 
Ogni componente è, a sua volta, un "con- 
tainer" destinato a contenere altri compo- 
nenti, e possiede per questo un proprio 
LayoutManager che serve a "disporre" in 
un certo modo i figli, che a loro volta pos- 
siedono dei LayoutManager per disporre 
secondo altri criteri i componenti "nipo- 
ti", e così via... 

Per cambiare LayoutManager ad un com- 
ponente è necessario fargli invocare il 
metodo setLayout che riceve come argo- 
mento proprio un LayoutManager... 
Nel tuo caso, quindi, o posizioni tuo 
JPanel al "center" del BorderLayout che già 
ti ritrovi, o provi qualche nuova soluzione 
adottando diversi LayoutManager o sem- 
plicemente non ne imposti nessuno! 
Per quest'ultima cosa basta richiamare il 



metodo setLayout passandogli come argo- 
mento nuli: 

setLayout(null) 

Il componente in questione, non posse- 
dendo quindi un LayoutManager disporrà 
tutto lo spazio disponibile assegnandolo al 
primo Component figlio. Ma fai prima a 
provare e vedere i risultati che a capire 
quello che ho scritto! 

Java: input da tastiera 

Scusate la banalità della 
domanda. Conosco bene il C e 
sto cercando di imparare il java! Per 
stampare a video uso system.out, 
ma per assegnare ad una variabile 
un valore scelto da tastiera? Cioè 
per simulare lo scanf ("%d", 
&intero) del e come faccio in java? 
Grazie in anticipo. 

Lupetto 

Risponde briz 

Non c'è niente di facile quando è la 
prima volta che si affronta un proble- 
ma! Dai un occhiata a questo esempio, 
dovrebbe darti una idea: 



String dato=null; 
int ris=0; 

try{ 

BufferedReader str = new BufferedReader( 

new InputStreamReader(System.in)); 
System. out.println("Prova a scrìvere un 

valore:"); 
dato=str.readLine(); 

System. out.println("Ecco cosa hai digitato: " 

+ dato); 
} 

Se poi vuoi assegnare il dato letto ad una 
variabile intera basta utilizzare questo 
comando: 

ris=Integer.parseInt(dato); 

Non escludo ci siano metodi più pratici, 
ma a me questo funziona di sicuro! 

PER CONTATTARCI 

e-mail: ioprogrammo@edmaster. it 

Posta: Edizioni Master, 

Via Cesare Correnti, 1 ■ 20123 Milano 
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CODEBEACH 

Un sito che si propone come 
guida al codice free e open 
source con tanto di tutorial su 
ASP, C++, C#, ColdFusion, 
Delphi/Kylix, Java, JavaScript, 
Palm, Perl, PHP, Pocket PC, 
Python, Visual Basic, e XML. 




www.codebeach.com/ 



DOTMET SPIDER 

Un guida online alle nuove 
tecnologie Microsoft orientate 
allo sviluppo di applicazione. 
Esempi, progetti, guide passo 
passo dedicate sia ai neofiti che 
ai programmatori esperti. 
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PROGRAMMARE MS VISUAL BASIC. NET 
(VERS. 2003) 

È una vera e propria guida di riferimento, di ben 1376 pagine! Offre una trat- 
tazione ampia e approfondita, completamente aggiornata, di Microsoft 
Visual Studio .NET 2003. Ricco di consigli preziosi, esempi pratici di codice e 
best practice, questo libro fornisce le informazioni necessarie per creare velo- 
cemente potenti applicazioni Win32 e soluzioni scalabili per il Web, compre- 
sa l'interazione con il common language runtime, multìthreading, le appli- 
cazioni Windows Forms, GDI+, Microsoft ADO.NET, i Web Form Microsoft 
ASENET e i Web service XML. Un'attenta analisi del testo vi permetterà di 
aumentare la produttività del linguaggio VB.NET, grazie a nuove caratteristi- 
che e tecniche per scrivere codice più veloce e più affidabile. Uno strumento 
di orientamento professionale che accresce le competenze necessarie per 
produrre soluzioni sofisticate per Microsoft Windows e per il Web. 

Difficoltà: Medio-Alta • Autori: Francesco Balena • Editore: Mondadori Informatica 
http://education.mondadori.it • ISBN: 88-04-53078-2 • Anno di pubblicazione: 2004 
Lingua: Italiano • Pagine: 1376 • Prezzo: € 75.00 

BEGimminiG .net game 

PROGRAMMIMG MI C# 

Grazie a questo testo potrete sfruttare al meglio le potenzialità di .NET 
per creare giochi divertenti e completi. Lo stile di scrittura è semplice e vi 
introdurrà alla programmazione in C# per sviluppare giochi in modo 
veloce. Il testo include anche un'introduzione alle DirectX9 e ad altre 
caratteristiche avanzate del .NET che vi consentiranno di utilizzare ani- 
mazioni e suoni. Il libro esamina, a tìtolo di esempio, cinque titoli in 
modo da offrire un approccio quanto più variegato alle diverse situazioni 
di gioco. I codici di esempio di riferiscono a giochi completi, quali 
".Nettrix" , ".Netterpillars", "River Pla.NET", "Magic KindergarteN", "D- 
Infect", "Nettrix II" (per Pocket PC), e una versione del classico gioco 
"Spacewars". In pochi passi scoprirete come trasformare un gioco 2D in 
3D, come creare personaggi con l'intelligenza artificiale, come creare gio- 
chi eseguibili in rete e tanto altro ancora. . . 

Difficoltà: Bassa • Autori: David Welter, Alexandre Santos Lobào, Eden Hatton 
Editore: Apress /www.apress.com • ISBN: 1-59059-319-7 • Anno di pubblicazione: 2004 

Lingua: inglese • Pagine: 468 • Prezzo: $ 44.99 




DELPHI GEMS 

Librerie, controlli, news, ed un 
ottimo forum di discussione sul 
linguaggio RAD per eccellenza: 
Delphi 
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www.delphi-gems.com 
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PROGRAMMARE MS OFFICE EXCEL 2003 
CON VB FOR APPLICATIONS E XML 

Il testo ideale per gli "smanettoni" dei fogli elettronici che vogliono appro- 
fondire le potenti funzionalità di programmazione a applicarle ai dati. Si 
tratta di una guida avanzata che fornisce tutte le informazioni necessarie 
per automatizzare i fogli elettronici, scrivere funzioni e procedure e creare 
soluzioni aziendali personalizzate. Uno sguardo completo sulla program- 
mazione con Microsoft Visual Basic for Applications (VBA), mediante l'uti- 
lizzo del modello a oggetti di Excel, che vi permetterà di modificare e per- 
sonalizzare gli oggetti di Excel, sfruttando le nuove funzionalità XML e inte- 
grando le funzioni di Excel con altri programmi di Microsoft Office e del 
Web. Nel CD allegato al libro c'è il codice di esempio, una versione di prova 
di "Spreadsheet Assistant", un eBook completo, una varietà di risorse per 
Excel, dimostrazioni e altro ancora... 

Difficoltà: Medio-Alta • Autori: Curtis Frye, Wayne S. Freeze, Felicia K. Buckingham 

Editore: Editore: Mondadori Informatica http://education.mondadori.it * ISBN: 88-04-53451-6 _ Anno 

di pubblicazione: 2004 • Lingua: Italiano • Pagine: 640 • Prezzo: € 65.00 
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